Skip to main content
POST
Create Topic

Authorizations

x-api-key
string
header
required

API key for authentication. You can create one here.

Body

application/json
website_id
string<uuid>
required
name
string
required

Topic name. Trimmed; blank rejected.

Maximum string length: 255
Example:

"Brand awareness"

description
string | null

Optional topic description.

Maximum string length: 2000

Response

Topic created (or existing topic returned when the name was already taken)

id
string<uuid>
required
name
string
required
description
string | null
required
created
boolean
required

False when an existing active topic with the same name was returned instead of creating a new one.