ONonlyfansapi
Smart Links

Create Smart Link Pixel

Changed on

Create a Team pixel and connect it to a Smart Link

post/api/smart-links/{smart_link_id}/pixels

Request

  • Base URL
    https://app.onlyfansapi.com
  • URL
    https://app.onlyfansapi.com/api/smart-links/{smart_link_id}/pixels
  • Auth
    HTTP bearer

Request body

platform'meta' | 'snapchat' | 'tiktok' | 'creatortraffic' required

Ad platform.

labelstring nullable

Display label. A platform label is generated when omitted. Must not be greater than 100 characters.

pixel_idstring required

Platform pixel ID. Not used by CreatorTraffic.

pixel_access_tokenstring required

Platform access token. This value is write-only.

event_source_urlstring nullable

Event source URL. Not used by CreatorTraffic. Must be a valid URL. Must not be greater than 2048 characters.

event_clickstring nullable

Platform event name. Must not be greater than 100 characters.

event_new_subscriberstring nullable

Platform event name. Must not be greater than 100 characters.

event_first_transactionstring nullable

Platform event name. Must not be greater than 100 characters.

event_new_transactionstring nullable

Platform event name. Must not be greater than 100 characters.

event_message_received_from_fanstring nullable

Platform event name. Must not be greater than 100 characters.

event_fan_sent_1_messagestring nullable

Platform event name. Must not be greater than 100 characters.

event_fan_sent_3_messagesstring nullable

Platform event name. Must not be greater than 100 characters.

event_page_viewstring nullable

Platform event name. Must not be greater than 100 characters.

event_new_followerstring nullable

Platform event name. Must not be greater than 100 characters.

supercharged_eventsstring[]

Must not be greater than 100 characters.

Example request

{
  "platform": "meta",
  "label": "Main Meta Pixel",
  "pixel_id": "1234567890",
  "pixel_access_token": "platform-access-token",
  "event_source_url": "https://example.com/prelander",
  "supercharged_events": [
    "gudl"
  ]
}

Response

Success

Example response

{
  "data": {
    "id": 123,
    "platform": "meta",
    "platform_label": "Meta Ads",
    "label": "Main Meta Pixel",
    "pixel_id": "1234567890",
    "event_source_url": "https://example.com/prelander",
    "event_click": "ViewContent",
    "event_new_subscriber": "Subscribe",
    "event_first_transaction": "Purchase",
    "event_new_transaction": "Purchase",
    "event_message_received_from_fan": null,
    "event_fan_sent_1_message": "Contact",
    "event_fan_sent_3_messages": "Lead",
    "event_page_view": "PageView",
    "status": "healthy",
    "traffic_source_ids": [],
    "traffic_sources": [],
    "created_at": "2026-07-24T08:00:00+00:00",
    "updated_at": "2026-07-24T08:00:00+00:00"
  },
  "_meta": {
    "_credits": {
      "used": 0,
      "balance": 999999,
      "note": "Free endpoint"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    }
  }
}

Changes