OnlyFans API
Media vault lists

Add Media To List

Add one or multiple media to a list.

POST
/api/{account}/media/vault/lists/{list_id}/media
AuthorizationBearer <token>

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

In: header

Path Parameters

accountstring

The Account ID

list_idstring

The ID of the list.

mediaIdsarray<string>

Array of media IDs to add.

Response Body

curl -X POST "https://app.onlyfansapi.com/api/string/media/vault/lists/string/media" \
  -H "Content-Type: application/json" \
  -d '{
    "mediaIds": [
      1234567890
    ]
  }'
{
  "data": {
    "id": 123,
    "type": "custom",
    "name": "My list",
    "hasMedia": true,
    "canUpdate": true,
    "canDelete": true,
    "videosCount": 0,
    "photosCount": 1,
    "gifsCount": 0,
    "audiosCount": 0,
    "medias": [
      {
        "type": "photo",
        "url": "https://cdn2.onlyfans.com/files/..."
      }
    ]
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 972,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 996,
      "remaining_day": 49917
    }
  }
}