Developer Docs

Integrate Chat33
with your stack.

Tracking pixel, webhook events, MMP install postbacks, and revenue tracking. Everything you need to connect Chat33 to your website or app.

Tracking Pixel Webhook Events Social Posting API AI Docs (llms.txt)MMP Postbacks Link Tracking UTM Builder App Store Links

Getting Started

To use the Chat33 developer integrations, you need an MMP Token. Find it in your dashboard at Settings → Integrations.

1. Get your token

Go to Settings → Integrations → MMP Token. Click "Generate Token" if you don't have one.

2. Choose your integration

Website / Web App

Use the Tracking Pixel to track page views, signups, and purchases.

Mobile App

Use MMP Postbacks (AppsFlyer, Adjust, Tenjin, Singular) to track installs.

Tracking Pixel

Track website events and attribute them to DM conversations

Installation

Add this script tag to your website's <head> or before </body>. Replace YOUR_TOKEN with your MMP token.

html

<script src="https://chat33.io/pixel.js" data-token="YOUR_TOKEN"></script>

Track Events

The pixel auto-tracks page views. To track custom events (purchases, signups, etc.), use the chat33.track() method:

javascript

// Track a purchase with value
chat33.track("purchase", {
  value: 49.99,
  currency: "USD",
  product: "Pro Plan"
});

// Track a signup
chat33.track("signup");

// Track a lead
chat33.track("lead", { source: "landing_page" });

// Track any custom event
chat33.track("tutorial_complete", { step: 5 });

How it works

Smart Links

Chat33 appends ?cid=xxx to tracked links in DMs

Auto-Attribution

The pixel reads the contact ID from the URL and persists it across pages

Auto-Tagging

Events like 'purchase' automatically tag the contact in your CRM

API Reference

Method	Parameters	Description
chat33.track(event, metadata?)	event: string, metadata: object	Send a custom event
chat33.identify(contactId)	contactId: string	Manually set the contact ID
chat33.getContactId()	—	Returns the current contact ID

Webhook Events API

Send custom events from your server to Chat33

Endpoint

http

POST https://chat33.io/api/webhooks/events?token=YOUR_TOKEN

Content-Type: application/json

{
  "event": "purchase",
  "contactId": "cm1abc123...",
  "value": 49.99,
  "currency": "USD",
  "metadata": {
    "product": "Pro Plan",
    "source": "checkout"
  }
}

Request Body

Field	Type	Required	Description
event	string	Yes	Event name (purchase, signup, lead, etc.)
contactId	string	No	Chat33 contact ID for attribution
value	number	No	Monetary value of the event
currency	string	No	Currency code (USD, EUR, etc.)
metadata	object	No	Any additional data

Examples

bash

# cURL
curl -X POST "https://chat33.io/api/webhooks/events?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"event":"purchase","value":29.99,"currency":"USD"}'

javascript

// Node.js / fetch
await fetch("https://chat33.io/api/webhooks/events?token=YOUR_TOKEN", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    event: "purchase",
    contactId: "cm1abc123...",
    value: 29.99,
    currency: "USD",
  }),
});

Rate limit: 100 events per minute per token. Events are stored as analytics events and contacts are automatically tagged based on event names (e.g., "purchase" → "Purchased" tag).

Social Posting API

Schedule and publish content to Instagram, Facebook, TikTok, YouTube, X (Twitter), and LinkedIn

Authentication

Generate an API key in Settings → API Keys. Include it as the x-api-key header in all requests.

bash

# All API requests require this header:
x-api-key: sk_live_your_api_key_here

Supported Platforms

Instagram

Photos, reels, carousels (via IG Graph API)

Facebook

Text, photos, videos with native scheduling

TikTok

Videos and photo posts via Content Posting API

YouTube

Video uploads with native scheduled publishing

X (Twitter)

Text, photos, video, and threads via X API v2 (consumes X credits)

Text, link cards, up to 9 images, or video, posted to the member's own profile

Create a Post

bash

curl -X POST "https://chat33.io/api/v1/posts" \
  -H "x-api-key: sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "accountIds": ["channel_id_here"],
    "text": "Check out our new product! #launch",
    "mediaUrls": ["https://your-blob-url.com/image.jpg"],
    "mediaType": "image"
  }'

Platform options (platformConfig)

Per-platform settings go under a key named after the platform. Only the keys for platforms in accountIds are read, so one request can carry options for several at once.

json

{
  "linkedin": {
    "visibility": "PUBLIC",            // or "CONNECTIONS" (1st-degree only)
    "articleUrl": "https://...",       // link card, ignored when the post has media
    "mediaTitle": "...",
    "mediaDescription": "..."
  },
  "youtube": {
    "madeForKids": false,              // required for any YouTube channel
    "title": "..."
  },
  "x": {
    "thread": true,                    // split text into a thread
    "splitOn": "---"
  },
  "tiktok": {
    "consent": {
      "publishMode": "DIRECT_POST",    // or "MEDIA_UPLOAD" (drafts)
      "privacyLevel": "SELF_ONLY"
    }
  }
}

LinkedIn specifics

Posts publish to the authenticated member's own profile. Company Pages need LinkedIn's Community Management API, which is a separate review, not supported yet.
One post carries up to 9 images or 1 video, never both. Over the limit is rejected rather than silently trimmed.
Caption caps at 3,000 characters. Video 200MB, images 10MB each.
articleUrl only applies to text posts. Media takes precedence and the link is ignored.
Access expires after 60 days and LinkedIn issues no refresh token, so the account must be reconnected manually. Publishing returns a clear reconnect error once it lapses.
LinkedIn throttles 150 API requests per member per day, and each image costs an extra two calls, so the cap is on requests, not post count.

Schedule a Post

bash

curl -X POST "https://chat33.io/api/v1/posts" \
  -H "x-api-key: sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "accountIds": ["ig_channel_id", "fb_channel_id"],
    "text": "Coming soon!",
    "mediaUrls": ["https://your-blob-url.com/video.mp4"],
    "mediaType": "video",
    "scheduledAt": "2026-04-15T14:00:00Z",
    "callbackUrl": "https://your-server.com/webhook"
  }'

Upload Media

Multipart upload is hard-capped at 4.5MB. Larger bodies are rejected with 413 FUNCTION_PAYLOAD_TOO_LARGE before reaching the API. For anything bigger, ingest from a public URL, or get a presigned URL and upload straight to storage.

bash

# Small files (< 4.5MB): multipart upload
curl -X POST "https://chat33.io/api/v1/media/upload" \
  -H "x-api-key: sk_live_your_key" \
  -F "file=@photo.jpg"

# Large files, already on a public URL: URL ingestion (up to 4GB)
curl -X POST "https://chat33.io/api/v1/media/upload" \
  -H "x-api-key: sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/large-video.mp4", "filename": "video.mp4"}'

# Large LOCAL file: presigned direct upload (up to 500MB per PUT)
# 1. ask for an upload URL
curl -X POST "https://chat33.io/api/v1/media/upload-url" \
  -H "x-api-key: sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"filename": "video.mp4", "contentType": "video/mp4", "size": 16352652}'
# -> {"uploadUrl": "https://...", "headers": {"content-type": "video/mp4"}, ...}

# 2. PUT the bytes straight to storage (never touches the API)
curl -X PUT "<uploadUrl>" \
  -H "Content-Type: video/mp4" \
  --data-binary @video.mp4
# -> {"url": "https://....public.blob.vercel-storage.com/...", ...}
#    pass that url in mediaUrls when creating the post

API Reference

Method	Endpoint	Description
POST	/api/v1/posts	Create & queue post(s)
GET	/api/v1/posts	List posts (paginated, filterable)
GET	/api/v1/posts/:id	Get post details
PATCH	/api/v1/posts/:id	Edit draft/queued post or cancel
DELETE	/api/v1/posts/:id	Delete draft or cancel post
POST	/api/v1/posts/:id/duplicate	Clone a post
POST	/api/v1/media/upload	Upload media (file under 4.5MB, or public URL)
POST	/api/v1/media/upload-url	Presigned URL for direct upload of a large local file

Request Body: Create Post

Field	Type	Required	Description
accountIds	string[]	Yes	Channel IDs to post to (max 10)
text	string	No	Post caption / description
mediaUrls	string[]	No	URLs to media files (uploaded via /media/upload)
mediaType	string	No	image, video, reel, or carousel
scheduledAt	string	No	ISO 8601 datetime for scheduling
callbackUrl	string	No	Webhook URL for publish notifications
platformConfig	object	No	Platform-specific options (YouTube title, privacy, etc.)
coverImageUrl	string	No	Cover/thumbnail image for videos

Rate limits: 50 posts per minute per organization. Per-channel daily limits: Instagram (25), Facebook (50), TikTok (20), YouTube (6), X (300).

Callbacks: When a post is published or fails, a POST request is sent to your callbackUrl with the post ID, status, and external post URL.

OpenAPI 3.1 Spec

Interactive endpoint explorer + machine-readable JSON for codegen, n8n, MCP.

JSON Explore

AI Docs · llms.txt

Markdown docs for Claude, ChatGPT, Cursor. Copy + paste so AI generates correct API calls.

Raw Copy for AI

n8n Node · community node

Official n8n community node. List accounts, create & schedule posts, upload media from any n8n workflow. Install n8n-nodes-chat33 from Settings → Community Nodes.

npm Docs

MCP Server

Connect Claude, Cursor, or any MCP client to Chat33. Post, pull analytics, and build DM flows with natural language.

Docs

MMP Install Postbacks

Track app installs from AppsFlyer, Adjust, Tenjin, or Singular

Postback URL

Configure this URL in your MMP dashboard as a postback endpoint. Replace YOUR_SECRET with your MMP Webhook Secret from Settings.

text

https://chat33.io/api/webhooks/mmp?secret=YOUR_SECRET

Supported MMPs

AppsFlyer

Reads event_type, app_id, appsflyer_id, af_sub1/af_sub2 for attribution

Adjust

Reads activity_kind, tracker_name, label for attribution

Tenjin

Reads campaign_id, site_id for attribution

Singular

Reads network, source for attribution

Smart Link Setup

Use the Smart Link node in your flows to generate download links. Chat33 automatically embeds the contact ID and influencer ID in the link parameters, so installs are attributed back to the DM conversation and campaign.

Add Smart Link node

In your flow, add a Smart Link node with your App Store / Google Play URLs

Configure MMP

Set up the postback URL in AppsFlyer/Adjust/Tenjin/Singular

Track installs

Installs are attributed to contacts and campaigns automatically

Link Tracking

Track clicks on links sent through DM automations

How it works

When you use tracked links in your flows, Chat33 wraps them in a redirect URL that records the click before forwarding to the destination. The contact ID is appended as a query parameter so downstream pages can identify the visitor.

text

# Original URL in your flow:
https://yoursite.com/signup

# What gets sent to the user:
https://chat33.io/api/t?url=https://yoursite.com/signup&cid=cm1abc...&fid=flow123

# User is redirected to:
https://yoursite.com/signup?cid=cm1abc...&fid=flow123

URL Parameters Appended

Parameter	Description
cid	Chat33 contact ID
fid	Flow ID that generated the link
ch	Channel ID

Tip: Combine link tracking with the tracking pixel. When a user clicks a tracked link and lands on your site, the pixel automatically reads the cid parameter and attributes all subsequent events to that contact.

UTM Campaign Link Builder

Generate tracked URLs with UTM parameters for Google Analytics

Website URL *

Campaign Source (utm_source)

Campaign Medium (utm_medium)

Campaign Name (utm_campaign)

Campaign Term (utm_term)

Campaign Content (utm_content)

Tip: Use UTM links in your Chat33 flow messages. When combined with the tracking pixel, you'll see the full journey from DM to conversion in Google Analytics.

App Store Campaign Links

Generate tracked download links for Apple App Store and Google Play

Store

Apple App ID *

Found in your App Store Connect URL: apps.apple.com/app/id[THIS_NUMBER]

Campaign Name

Provider Token

For Chat33 Campaigns: Use these links in your DM flows with the Smart Link node. Chat33 will automatically append the contact ID and influencer ID so installs are attributed back to your campaign.

MMP Integration: If you use AppsFlyer, Adjust, Tenjin, or Singular, use their OneLink/tracking URLs instead, and configure the Chat33 postback URL in your MMP dashboard. See the MMP Postbacks section.

Need help integrating?

Our team can help you set up tracking and get the most out of Chat33's developer tools.

Get Started Free Contact Support

Integrate Chat33with your stack.

Getting Started

1. Get your token

2. Choose your integration

Tracking Pixel

Installation

Track Events

How it works

API Reference

Webhook Events API

Endpoint

Request Body

Examples

Social Posting API

Authentication

Supported Platforms

Create a Post

Platform options (platformConfig)

LinkedIn specifics

Schedule a Post

Upload Media

API Reference

Request Body: Create Post

MMP Install Postbacks

Postback URL

Supported MMPs

Smart Link Setup

Link Tracking

How it works

URL Parameters Appended

UTM Campaign Link Builder

App Store Campaign Links

Need help integrating?

Integrate Chat33
with your stack.