Skip to main content
Callbacks (postbacks) let you receive real-time notifications about events: new subscribers, transactions, and Smart Link clicks. Data is sent to your URL with populated macros.

​
Available Events

EventWhen It Fires
new_subscriberA new fan subscribed through your link
new_transactionA fan made a purchase (PPV, tips, subscription, etc.)
smartlink_clickClick on a Smart Link (Smart Links only)
marketing_stopCampaign stopped

​
Configuration

Callbacks can be configured at three levels:
  1. Default — in account settings. Applied to all new campaigns.
  2. Per campaign — individual settings for a specific campaign.
  3. Per Smart Link — configured when creating a Smart Link.
Each event can be configured separately:
  • URL with macros
  • HTTP method — GET or POST
  • Request body (POST only) with macros
  • Headers — custom HTTP headers

​
Macros

​
Subscriber (new_subscriber)

MacroDescription
{{event}}new_subscriber
{{campaign.id}}Campaign ID
{{campaign.name}}Campaign name
{{subscriber.id}}Subscriber’s OnlyFans ID
{{subscriber.name}}Subscriber name
{{subscriber.revenue}}Your total revenue from this subscriber
{{subscriber.date_subscribe}}Subscription date (UNIX)
{{subscriber.click_id}}External click_id (Smart Links)

​
Transaction (new_transaction)

MacroDescription
{{event}}new_transaction
{{transaction.id}}Transaction ID
{{transaction.type}}Type: tip, message, post, subscription, resubscription, stream
{{transaction.amount}}Transaction amount
{{transaction.revenue}}Your share
{{transaction.date}}Transaction date (UNIX)
{{subscriber.click_id}}External click_id (Smart Links)
MacroDescription
{{event}}smartlink_click
{{click.click_id}}Internal click ID
{{click.external_click_id}}Your click_id from the URL
{{click.url}}Redirect URL
{{click.expires_ts}}Expiration time (UNIX)
{{click_params.*}}Any parameters from params[key] in the URL

​
Campaign Stop (marketing_stop)

MacroDescription
{{event}}marketing_stop
{{campaign.id}}Campaign ID
{{campaign.name}}Campaign name
{{campaign.date_create}}Creation date (UNIX)
{{campaign.date_finish}}Stop date (UNIX)

​
Examples

GET request for a tracker: 
https://tracker.example.com/postback?event={{event}}&click_id={{subscriber.click_id}}&revenue={{transaction.revenue}}&type={{transaction.type}}
POST request with JSON: URL: https://api.example.com/webhook Body: 
{
  "event": "{{event}}",
  "click_id": "{{subscriber.click_id}}",
  "revenue": "{{transaction.revenue}}",
  "subscriber": "{{subscriber.name}}"
}

​
Testing

The callback settings interface has a Test button — it sends a test request with populated macros so you can verify your integration before going live.

​
Request Processing

  • Requests are sent with User-Agent: OnlyTraffic-postback
  • Timeout: 20 seconds
  • On connection errors (timeout, refused, SSL) — up to 3 retries
  • Log of all sent callbacks is available in the Postbacks section