Campaigns

Create a campaign

Creates a new campaign workspace. A Campaign is a named container that groups related audiences and deliveries under a single context — useful for organising a body of work such as a quarterly prospecting initiative or a product-launch outreach.

Campaign association is optional. Audiences, file-match jobs, and deliveries all work independently without a campaign. Use campaigns when you want to track related work together in the first-party campaign workspace and activity views.

After creation, associate audiences with the campaign by:

  • Passing campaign_id to POST /v1/audiences or POST /v1/match/file at creation time (auto-links on creation).
  • Calling POST /v1/campaigns/{id}/audiences/{audience_id} to link an existing audience.

Requires 'creator' scope.

post/v1/campaigns

Request

  • Base URL: https://api.infiniteaudience.ai
  • URL: https://api.infiniteaudience.ai/v1/campaigns
  • Auth: HTTP bearer

Request body

namestring required

Display name for the campaign.

descriptionstring

Optional campaign brief, intended market, goals, and constraints.

Response

Campaign created.

idstring required

Unique campaign identifier.

namestring required

Display name of the campaign.

descriptionstring required

User-authored campaign brief, intended market, goals, and constraints.

status'active' | 'archived' required

Lifecycle state of the campaign.

created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.