Sign in

v8

latestOpenAPI 3.0.3raw.githubusercontent.com2026-05-2526602.8 MB
Smart Link Postbacks

Create Smart Link Postback

Create a postback that fires for selected Smart Link conversion types

post/api/smart-link-postbacks

Request body

urlstring required

The destination URL. Variables such as {click_id}, {fbclid}, {gclid}, and {ttclid} 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={click_id}&type={conversion_type}&gclid={gclid}",
  "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}",
    "smart_link_scope": "global",
    "conversion_types": [
      "new_subscriber",
      "new_transaction"
    ],
    "smart_link_ids": [],
    "smart_links": [],
    "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"
    }
  }
}