Skip to main content
POST
Create Engage campaign

Authorizations

Authorization
string
header
required

Partner OAuth2 flows for integration API access tokens. Claude MCP custom connectors use authorization code with PKCE S256.

Headers

X-Organization-Id
string<uuid>

Active organization UUID. Required for authenticated requests when the principal has access to multiple organizations.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$

Query Parameters

organizationId
string<uuid>

Read-only convenience alias for X-Organization-Id. Legacy subscriberId query param is also accepted.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$

Body

application/json
name
string
required
Required string length: 1 - 300
isPublic
boolean
accountId
string<uuid>
Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
accountTypes
string[]
accountStatuses
string[]
persona
string[]
steps
object[]

Preferred way to define the campaign: ordered steps compiled server-side into nodes/edges. Mutually exclusive with nodes/edges; must include at least one send step.

Required array length: 1 - 50 elements
nodes
object[]
edges
object[]
viewport
object
cutoffAt
string<date-time>
cutoffTimezone
string
ownerUserId
string<uuid>

Organization user that owns the campaign. Required for client-credential tokens; user tokens default to the authenticated user.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$

Response

Created campaign.

campaign
object
required