Skip to main content
POST
Create messaging ad

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
channel
enum<string>
required

Channel to run the messaging ad on.

Available options:
messenger,
instagram,
whatsapp
integrationId
string
required

Channel integration id (numeric string).

Pattern: ^\d+$
adAccountId
string
required

Meta ad account id (act_). Get it from ads.listCampaignAdAccounts.

Pattern: ^act_\d+$
name
string
required

Campaign name.

Required string length: 1 - 120
campaign
object
required

Campaign-level settings.

adSet
object
required

Ad set-level settings.

creative
object
required

Ad creative settings.

whatsappPageIntegrationId
string

Messenger page integration id, required when channel is whatsapp.

Pattern: ^\d+$

Response

OK

id
string
required
channel
string
required
adAccountId
string
required
name
string
required
createState
string
required
publishState
string
required
metaCampaignId
string | null
required
metaAdSetId
string | null
required
metaAdCreativeId
string | null
required
metaAdId
string | null
required
lastError
string | null
required
cleanupError
string | null
required
effectiveStatus
string | null
required
createdAt
string<date-time>
required