CampaignsTrigger campaign

Trigger campaign

Trigger a webhook campaign for its configured audience. The campaign id is workspace-agnostic in the path, but the body's workspace_id is required and must match the API key's workspace. Requires the campaigns:trigger permission.

Only campaigns with trigger_type: webhook in active status can be triggered this way — anything else is a 400. The audience comes from the campaign's own configuration; you cannot pass user ids or filters here.

curl -X POST "https://api.flameup.ai/api/v1/campaigns/example_string/trigger" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "workspace_id": "example_string",
  "trigger_data": {}
}'
{
  "success": true,
  "campaign_id": "example_string",
  "people_queued": 42,
  "audience_truncated": true,
  "status": "processing",
  "triggered_at": "2024-12-25T10:00:00Z",
  "message": "example_string"
}
POST
/campaigns/{campaignId}/trigger
POST
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Your Flameup API key (passed as Bearer token)

Your Flameup API key (passed as Bearer token)
Content-Typestring
Required

The media type of the request body

Options: application/json
workspace_idstring
Required

Must equal the workspace the API key belongs to; any other value is a 403.

trigger_dataobject

Optional context data passed into the workflow execution for this trigger.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Your Flameup API key (passed as Bearer token)

Path Parameters

Body

application/json
workspace_idstring
Required

Must equal the workspace the API key belongs to; any other value is a 403.

trigger_dataobject

Optional context data passed into the workflow execution for this trigger.

Responses