Skip to content
Fans API
Snapchat

Connect your Snapchat ads. Track subscriptions and revenue.

Use Smart Links to send configured conversion events to Snap Conversions API. Read clicks, subscribers and revenue in your own app.

  • Click attribution
  • Conversion events
  • Campaign reporting

Trusted by teams building with FansAPI

[Why FansAPI?]

Configure the connection. Build your product.

See what Smart Links handles for you, compared with building a direct Snap Conversions API integration.

Fans APISmart Links
SnapchatConversions API · Direct
Click attributionCapture the Snapchat click ID through your Smart Link.
Click attributionPass the click ID or landing-page URL in your event payload.
Event mappingChoose or disable event mappings in pixel settings.
Event mappingMap your app’s actions to Snapchat event names in code.
Event deliveryForward configured Smart Link events to Snapchat.
Event deliveryBuild and send the server-to-server event requests.
Testing & troubleshootingSend a test from settings and inspect pixel event logs.
Testing & troubleshootingUse Snap’s validation endpoints and Events Manager.
Link-level reportingRead clicks, subscribers and revenue from one stats API.
Link-level reportingBuild your link-level reporting alongside the event integration.

Fans API

Smart Links
  • Click attributionCapture the Snapchat click ID through your Smart Link.
  • Event mappingChoose or disable event mappings in pixel settings.
  • Event deliveryForward configured Smart Link events to Snapchat.
  • Testing & troubleshootingSend a test from settings and inspect pixel event logs.
  • Link-level reportingRead clicks, subscribers and revenue from one stats API.

Snapchat

Conversions API · Direct
  • Click attributionPass the click ID or landing-page URL in your event payload.
  • Event mappingMap your app’s actions to Snapchat event names in code.
  • Event deliveryBuild and send the server-to-server event requests.
  • Testing & troubleshootingUse Snap’s validation endpoints and Events Manager.
  • Link-level reportingBuild your link-level reporting alongside the event integration.

Both approaches need a Snap Pixel ID and an access token. Your ad campaigns stay in Snapchat Ads Manager.

[How it works]

From a Snap ad to a tracked action.

Configure the connection once, then follow the events that matter to your campaign.

  1. 01

    Connect your pixel

    Add your Snap Pixel ID and Conversions API token in Smart Links → Tracking Pixels.

  2. 02

    Attach it to a Smart Link

    Select the pixel, choose your event mappings and use the Smart Link as your ad’s destination.

  3. 03

    Test, then track

    Send a test event. Inspect delivery in the event logs and read your Smart Link’s performance through the API.

[Built into the connection]

Put your campaign data to work.

A closer look at the Snapchat integration, from connection to reporting.

Connect your Snap Pixel

Attach a Pixel ID and Conversions API token to your Smart Link’s tracking setup.

Capture the ad click

Smart Links captures Snapchat’s ScCid click ID for attribution. No URL macro to add.

Choose the events you send

Map each action to a standard or custom Snapchat event, or turn individual events off.

Read campaign results

Query clicks, subscribers, revenue and spenders, with daily and monthly metrics.

Test your connection

Send a test event from your pixel settings and check it in Snapchat Events Manager.

Inspect event delivery

Use pixel event logs to investigate rejected payloads, credentials and delivery failures.

[Make it part of your product]

Your campaign. In your code.

Read a Smart Link’s summary, daily and monthly metrics from your backend.

const response = await fetch(
  `https://app.onlyfansapi.com/api/smart-links/${process.env.SMART_LINK_ID}/stats`,
  { headers: {
    Authorization: `Bearer ${process.env.FANSAPI_API_KEY}`,
    Accept: "application/json"
  }}
);

const { data } = await response.json();
console.log(data.summary);
GET/api/smart-links/{smart_link_id}/stats
[Event mapping]

Your actions. The right signals.

Start with the default mappings, then choose which events your pixel sends.

Smart Link actionSnapchat eventWhen it happens
Link clickVIEW_CONTENTA fan clicks the Smart Link.
New subscriberSIGN_UPA fan subscribes through the link.
First purchasePURCHASEThe first transaction other than the initial subscription payment.
Repeat purchasePURCHASEOther transactions, including the initial subscription payment.
Third inbound messageLEVEL_COMPLETEA converted fan reaches their third inbound message.

Each mapping can be changed or disabled in your pixel’s Event Configuration.

[Before you start]

Everything you need to connect.

Prepare your account and credentials, then choose the plan that fits your workflow.

  • Smart Links access

    An active account with Smart Links enabled and a connected account for the campaign.

  • Snapchat Ads account

    Business Manager access. Organization Admin permissions are needed to generate the API token.

  • Pixel ID & API token

    Use credentials from the same organization. Keep tokens on your backend.

A plan for your workflow.

Check your FansAPI plan for Smart Links access and pixel limits. Your Snapchat advertising budget is managed separately in Snapchat Ads Manager.

Explore pricing
[FAQ]

Building with Snapchat?

The essentials before your first request.

Snapchat

Bring your next campaign into focus.

Connect your pixel, configure your events and follow the results.

  • 99.9% availability target
  • Documented event mappings
  • Server-side tracking