Skip to main content
POST
Get messaging ad insights

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 the integration belongs to.

Available options:
messenger,
instagram,
whatsapp
integrationId
string
required

Channel integration id (numeric string).

Pattern: ^\d+$
adAccountId
string
required

Meta ad account id (act_).

Pattern: ^act_\d+$
adIds
string[]
required

Ad ids to fetch insights for, up to 500.

Required array length: 1 - 500 elements
Minimum string length: 1
datePreset
enum<string>

Meta date preset for the insights window.

Available options:
maximum,
last_30d,
last_7d
refresh
boolean

Force an uncached refresh from Meta instead of serving cached data.

Response

OK

data
object[]
required