Conversions API

Conversion tracking lets Meta optimize a campaign toward a specific conversion
event (e.g. a purchase or sign-up) instead of link clicks alone. You enable it
per campaign by adding a conversionConfig to your campaignInput.

Meta only. Conversion optimization applies to adPlatform: "meta"
campaigns. TikTok campaigns ignore conversionConfig.

`conversionConfig`

Field	Type	Required	Description
`pixelId`	string	yes	The Meta Pixel that records the conversion events.
`conversionEvent`	string	yes	The event to optimize toward (e.g. `"Purchase"`, `"Lead"`).

When conversionConfig.conversionEvent is present, the campaign is created with
conversion optimization enabled for that event. Omit conversionConfig entirely
to run a standard (non-conversion) campaign.

Example

{
  "adPlatform": "meta",
  "brandId": 12345,
  "campaignInput": {
    "name": "Pre-save Conversion Campaign",
    "startDate": "2026-08-01T00:00:00.000Z",
    "endDate": "2026-08-14T00:00:00.000Z",
    "budget": 400,
    "currency": "USD",
    "promotedLink": "https://your-presave.com/track",
    "captions": ["Pre-save the album"],
    "callToAction": "LEARN_MORE",
    "targetingConfig": {
      "geographies": [
        { "id": "US", "type": "country", "name": "United States", "percentage": 100 }
      ],
      "audiences": [],
      "languages": [{ "id": "6", "name": "English" }],
      "genders": ["MALE", "FEMALE"],
      "minAge": 18,
      "maxAge": 55
    },
    "conversionConfig": {
      "pixelId": "1234567890",
      "conversionEvent": "Purchase"
    }
  }
}

The campaign is submitted through the same Create Campaigns
endpoint — conversionConfig is simply an additional field on campaignInput.