Smart Link Postbacks
Update Smart Link Postback
Update a Smart Link postback configuration
Authorization
default AuthorizationBearer <token>
Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
postback_id*integer
The postback ID
Request Body
application/json
url*string
The destination URL.
smart_link_scope*string
global or campaign_specific.
Value in
"global" | "campaign_specific"conversion_types*array<string>
One or more Smart Link conversion types that should trigger this postback.
smart_link_ids?array<string>
Smart Link ULIDs. Required when smart_link_scope is campaign_specific.
Response Body
application/json
curl -X PATCH "https://app.onlyfansapi.com/api/smart-link-postbacks/123" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/postback?click={click_id}&type={conversion_type}", "smart_link_scope": "global", "conversion_types": [ "new_subscriber" ] }'{
"data": {
"id": 123,
"url": "https://example.com/updated?click={click_id}&type={conversion_type}&ttclid={ttclid}",
"smart_link_scope": "campaign_specific",
"conversion_types": [
"new_subscriber"
],
"smart_link_ids": [
"01JTESTLINK000000000000001"
],
"smart_links": [
{
"link_ulid": "01JTESTLINK000000000000001",
"name": "Instagram Bio Link",
"account_display_name": "Creator Main",
"account_prefixed_id": "acct_XXXXXXXX"
}
],
"latest_response": null,
"created_at": "2026-01-31T21:45:00+00:00",
"updated_at": "2026-01-31T22:00:00+00:00"
},
"_meta": {
"_credits": {
"used": 0,
"balance": 999999,
"note": "Free endpoint"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
}
}
}