GTM Campaigns

Attach Audience To Campaign

Attach (or detach) a saved list to a campaign as its audience.

This is the missing link in Daniel's MCP flow: find list → create campaign → attach audience → launch was previously a dead-end because no REST/MCP path could set cb_campaigns.audience_list_id (the FE "Attach Audience" dialog only went through an internal route).

Idempotent — setting the same list twice is a 200, no error. Pass list_id=null to detach. The launch endpoint reads cb_campaigns.audience_list_id when enrolling contacts; without it, launch creates a sequence with zero enrollment.

put/campaigns/{campaign_id}/audience

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/campaigns/{campaign_id}/audience
  • Auth: HTTP bearer

Path parameters

campaign_idstring required

Campaign ID

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

list_idstring nullable

List ID to attach as the campaign's audience. Pass null to detach. The list must already exist in this org (matches audiences.id, the canonical lists table — accepts an integer or its string form).

Response

Successful Response

dataobject required

Changes

No recorded changes to this operation across all 2 revisions of this API.