Skip to main content
PATCH
Update an audience

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

audienceId
string
required

Audience id.

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

Body

application/json
name
string
Required string length: 1 - 160
description
string

Who these people are, in plain words. Drives targeting.

Maximum string length: 4000
keywords
string[]
Maximum array length: 200
Required string length: 1 - 200
topics
string[]
Maximum array length: 100
Required string length: 1 - 200
tags
string[]
Maximum array length: 50
Required string length: 1 - 100
dataStoreIds
string[]

Data stores this audience is built from.

Maximum array length: 25

Data store id.

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

Response

Success

id
string
required
name
string
required
description
string
required
kind
string
required

custom, rfp (from a brief) or preset.

keywords
string[]
required
topics
string[]
required
tags
string[]
required
dataStoreIds
string[]
required
createdAt
string | null
required
updatedAt
string | null
required