Set Fan's Custom Name - OnlyFans API Documentation

Authorization

AuthorizationBearer <token>

Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys

In: header

Path Parameters

accountstring

The Account ID

fan_idstring

Fan's OnlyFans ID

Request Body

custom_namestring

New Custom Name for a Fan

Response Body

curl -X PUT "https://app.onlyfansapi.com/api/string/fans/string/custom-name" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_name": "🐳Whale ($100+)"
  }'

{
  "data": {
    "view": "x",
    "avatar": "https://public.onlyfans.com/files/q/...",
    "avatarThumbs": {
      "c50": "https://thumbs.onlyfans.com/public/files/thumbs/c50/q/...",
      "c144": "https://thumbs.onlyfans.com/public/files/thumbs/c144/q/..."
    },
    "header": "https://public.onlyfans.com/files/2/2j/2jy/...",
    "headerSize": {
      "width": 792,
      "height": 396
    },
    "headerThumbs": {
      "w480": "https://thumbs.onlyfans.com/public/files/thumbs/w480/2/2j/2jy/...",
      "w760": "https://thumbs.onlyfans.com/public/files/thumbs/w760/2/2j/2jy/..."
    },
    "id": 11223344,
    "name": "John Doe",
    "username": "john-doe",
    "canLookStory": false,
    "canCommentStory": false,
    "hasNotViewedStory": false,
    "isVerified": true,
    "canPayInternal": true,
    "hasScheduledStream": false,
    "hasStream": false,
    "hasStories": false,
    "tipsEnabled": false,
    "tipsTextEnabled": false,
    "tipsMin": 5,
    "tipsMinInternal": 1,
    "tipsMax": 200,
    "canEarn": true,
    "canAddSubscriber": true,
    "subscribePrice": 0,
    "displayName": "🐳Whale ($100+)",
    "notice": "",
    "isPaywallRequired": true,
    "isRestricted": false,
    "canRestrict": true,
    "subscribedBy": null,
    "subscribedByExpire": null,
    "subscribedByExpireDate": "2022-02-10T19:43:21+00:00",
    "subscribedByAutoprolong": null,
    "subscribedIsExpiredNow": true,
    "currentSubscribePrice": null,
    "subscribedOn": null,
    "subscribedOnExpiredNow": true,
    "subscribedOnDuration": "12 days",
    "listsStates": [
      {
        "id": "recent",
        "type": "recent",
        "name": "Recent (last 24 hours)",
        "hasUser": false,
        "canAddUser": false,
        "cannotAddUserReason": "SYSTEM_LIST"
      },
      {
        "id": "following",
        "type": "following",
        "name": "Following",
        "hasUser": false,
        "canAddUser": false,
        "cannotAddUserReason": "SYSTEM_LIST"
      },
      {
        "id": 859770744,
        "type": "bookmarks",
        "name": "Bookmarks",
        "hasUser": false,
        "canAddUser": true,
        "cannotAddUserReason": null
      },
      {
        "id": "fans",
        "type": "fans",
        "name": "Fans",
        "hasUser": false,
        "canAddUser": false,
        "cannotAddUserReason": null
      },
      {
        "id": "friends",
        "type": "friends",
        "name": "Friends",
        "hasUser": false,
        "canAddUser": true,
        "cannotAddUserReason": null
      },
      {
        "id": "rebill_off",
        "type": "rebill_off",
        "name": "Renew Off",
        "hasUser": false,
        "canAddUser": false,
        "cannotAddUserReason": null
      },
      {
        "id": "rebill_on",
        "type": "rebill_on",
        "name": "Renew On",
        "hasUser": false,
        "canAddUser": false,
        "cannotAddUserReason": null
      },
      {
        "id": "muted",
        "type": "muted",
        "name": "Muted",
        "hasUser": false,
        "canAddUser": true,
        "cannotAddUserReason": null
      },
      {
        "id": "tagged",
        "type": "tagged",
        "name": "Tagged",
        "hasUser": false,
        "canAddUser": false,
        "cannotAddUserReason": "SYSTEM_LIST"
      }
    ],
    "canReport": true,
    "canReceiveChatMessage": false,
    "hideChat": false,
    "lastSeen": "2025-10-12T23:57:50+00:00",
    "isPerformer": true,
    "isRealPerformer": true,
    "subscribedByData": {
      "price": 0,
      "newPrice": 0,
      "regularPrice": 0,
      "subscribePrice": 0,
      "discountPercent": 0,
      "discountPeriod": 1,
      "subscribeAt": "2021-11-12T19:43:21+00:00",
      "expiredAt": "2022-02-10T19:43:21+00:00",
      "renewedAt": null,
      "discountFinishedAt": null,
      "discountStartedAt": null,
      "status": null,
      "isMuted": false,
      "unsubscribeReason": "No reason given",
      "duration": "2 months",
      "showPostsInFeed": true,
      "newPostsAfterExpireCount": 266,
      "subscribes": [],
      "hasActivePaidSubscriptions": false
    },
    "subscribedOnData": {
      "price": 0,
      "newPrice": 0,
      "regularPrice": 4.99,
      "subscribePrice": 4.99,
      "discountPercent": 0,
      "discountPeriod": 1,
      "subscribeAt": "2025-07-30T15:06:53+00:00",
      "expiredAt": "2025-08-11T18:04:17+00:00",
      "renewedAt": null,
      "discountFinishedAt": null,
      "discountStartedAt": null,
      "status": null,
      "isMuted": false,
      "unsubscribeReason": "No reason given",
      "duration": "12 days",
      "tipsSumm": 0,
      "subscribesSumm": 0,
      "messagesSumm": 0,
      "postsSumm": 0,
      "streamsSumm": 0,
      "totalSumm": 0,
      "subscribes": [],
      "hasActivePaidSubscriptions": false
    },
    "canTrialSend": false,
    "isBlocked": false,
    "isPendingAutoprolong": false
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 224616,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 997,
      "remaining_day": 49987
    }
  }
}