Skip to main content
POST
Add an audience to a campaign

Authorizations

Authorization
string
header
required

An API key from Settings → API access, starting with fnd_.

Headers

Idempotency-Key
string

Any unique string. Repeating a request with the same key returns the first result instead of doing it twice.

Maximum string length: 200

Path Parameters

campaignId
string
required

Campaign id.

Pattern: ^[a-f0-9]{24}$

Body

application/json
audienceId
string
required

Audience id.

Pattern: ^[a-f0-9]{24}$
generateTargeting
boolean

Start generating targeting now. Default true.

Response

Success

id
string
required
name
string
required
status
string
required

draft, loading (collecting data), ready or error.

objective
string
required
brandId
string | null
required
brand
object
required
industry
string
required
language
string
required
locations
string[]
required
successMetrics
string[]
required
campaignType
string | null
required
budget
number | null
required

In the account's currency.

budgetType
enum<string> | null
required
Available options:
daily,
total
endDate
string | null
required
biddingStrategy
string | null
required
targetCpa
number | null
required
targetRoas
number | null
required
audiences
object[]
required
googleAds
object
required
url
string
required

Opens the campaign in Fandom.

createdAt
string | null
required
updatedAt
string | null
required