Configure a server-to-server conversions API integration (Meta/TikTok/Google Ads)

POST

/api/v1/capi-integrations

curl --request POST \
  --url https://example.com/api/v1/capi-integrations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "provider": "meta", "credentials": { "pixelId": "1234567890", "accessToken": "EAAG..." }, "statusMapping": { "lead": "Lead", "sale": "Purchase" }, "isActive": true }'

Authorizations

• bearer

Request Body^required

Media typeapplication/json

object

provider

required

string

Allowed values: meta tiktok google_ads

credentials

required

Provider-specific credentials — Meta: { pixelId, accessToken }; TikTok: { pixelCode, accessToken }; Google Ads: { customerId, conversionActionId, developerToken, clientId, clientSecret, refreshToken; optional: loginCustomerId, adUserDataConsent (GRANTED|DENIED)}

object

Example

{
  "pixelId": "1234567890",
  "accessToken": "EAAG..."
}

statusMapping

required

Maps our conversion statuses to the event name the provider expects

object

Example

{
  "lead": "Lead",
  "sale": "Purchase"
}

isActive

boolean

default: true

Responses

201

Media typeapplication/json

object

id

required

string

provider

required

string

Allowed values: meta tiktok google_ads

statusMapping

required

object

isActive

required

boolean

hasCredentials

required

boolean

createdAt

required

string

updatedAt

required

string

Example

{
  "provider": "meta"
}