Smart Link Postbacks

Create Smart Link Postback

Changed on

Create a postback that fires for selected Smart Link conversion types

post/api/smart-link-postbacks

Request

  • Base URL
    https://app.onlyfansapi.com
  • URL
    https://app.onlyfansapi.com/api/smart-link-postbacks
  • Auth
    HTTP bearer

Request body

urlstring required

The destination URL. Variables such as {external_click_id}, {fbclid}, {gclid}, {gbraid}, {wbraid}, {ttclid}, and {sccid} are replaced when the postback is dispatched.

http_method'GET' | 'POST'

HTTP method used for the postback request. Defaults to GET when omitted.

bodystring

Optional request body template for POST postbacks. Variables are replaced when the postback is dispatched.

smart_link_scope'global' | 'campaign_specific' required

global fires for all Smart Links. campaign_specific fires only for selected Smart Links.

conversion_typesstring[] required

One or more Smart Link conversion types that should trigger this postback.

smart_link_idsstring[]

Smart Link ULIDs. Required when smart_link_scope is campaign_specific.

Example request

{
  "url": "https://example.com/postback?click={external_click_id}&type={conversion_type}&gclid={gclid}",
  "http_method": "POST",
  "body": "{\"click_id\":\"{click_id}\",\"value\":\"{amount_gross}\"}",
  "headers": [
    {
      "name": "Authorization",
      "value": "Bearer token"
    }
  ],
  "smart_link_scope": "campaign_specific",
  "conversion_types": [
    "new_subscriber",
    "new_transaction"
  ],
  "smart_link_ids": [
    "01JTESTLINK000000000000001"
  ]
}

Response

Success

Example response

{
  "data": {
    "id": 123,
    "url": "https://example.com/postback?click={click_id}&type={conversion_type}&gclid={gclid}",
    "http_method": "POST",
    "body": "{\"click_id\":\"{click_id}\",\"value\":\"{amount_gross}\"}",
    "headers": [
      {
        "name": "Authorization",
        "value": "Bearer token"
      }
    ],
    "smart_link_scope": "global",
    "conversion_types": [
      "new_subscriber",
      "new_transaction"
    ],
    "smart_link_ids": [],
    "smart_links": [],
    "traffic_source_ids": [],
    "traffic_sources": [],
    "latest_response": null,
    "created_at": "2026-01-31T21:45:00+00:00",
    "updated_at": "2026-01-31T21:45:00+00:00"
  },
  "_meta": {
    "_credits": {
      "used": 0,
      "balance": 999999,
      "note": "Free endpoint"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    }
  }
}

Changes

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      endpoint added