Topics
Create topic
Create a new topic for a project. Topics let you segment your audience and manage subscription preferences by interest or category.
Requirements
- Permission:
contacts:write. - Project access: the path project must match the API key’s project.
- HTTP rate limit: 120 requests per 60 seconds per API key.
POST
TypeScript
Authorizations
Project-bound Apollo Signal API key. Keys begin with ap_signal_ and must carry the permission shown on the operation.
Path Parameters
The ID of the project to create the topic in.
Body
application/json
Topic creation parameters.
Definition and default consent behavior for a new topic.
State assigned when a contact has no explicit preference for this topic.
Available options:
opt_in, opt_out Topic name after trimming; 1 to 200 characters.
Maximum string length:
200Optional developer-facing explanation of the topic.
Topic visibility. Defaults to private.
Available options:
public, private Response
Topic created successfully.