List broadcasts / marketing messages

List a workspace's broadcasts (metadata only — insight numbers live on the details endpoint). `isMM` selects the family and is **required**: `false` = organic re-engagement broadcasts, `true` = Meta (paid) marketing messages. Optional `type` and `includeArchived` filters; newest first. `workspaceId` is **required**.

GET/broadcasts

Authorization

x-api-key x-date x-signature

x-api-key<token>

Your API key (the ApiKeys document id).

In: header

x-date<token>

Current timestamp in ISO-8601 (must be fresh — within −5s..+60s of server time).

In: header

x-signature<token>

HMAC-SHA256 of the x-date string keyed by your secret, lowercase hex.

In: header

Query Parameters

workspaceId*string

The VIP workspace id (from GET /workspaces).

isMM*string

false = organic broadcasts; true = Meta marketing messages.

type?string

Filter to a single broadcast type.

includeArchived?string

When true, also include archived (non-visible) broadcasts.

limit?integer

Max broadcasts to return.

Response Body

`application/json`

curl -X GET "https://example.com/broadcasts?workspaceId=string&isMM=true"

[  {    "id": "string",    "name": "string",    "type": "SINGLE",    "target": "string",    "active": true,    "isMM": true,    "workspaceId": "string",    "mediumId": "string",    "mediumName": "string",    "scheduled": true,    "scheduledFor": "string",    "frequency": "string",    "lastSentAt": "string",    "nextSendAt": "string",    "lastExecutionId": "string",    "metaMessageCampaignName": "string",    "createdAt": "string"  }]

{  "message": "string"}

{  "message": "string"}

{  "error": [    {      "message": "string",      "path": [        "string"      ],      "type": "string",      "context": {}    }  ]}

Authorization

Query Parameters

Response Body

200application/json

402application/json

403application/json

422application/json

`application/json`

`application/json`

`application/json`

`application/json`