Quick Start — Topics

A topic is a subject the person agrees to receive (Newsletter, Promotions). Different from a tag (internal label).

In brief

Create the topic with a name and stable slug.
Link it to a MARKETING category template.
Filter segments with a type: topic rule.

Context: Communication topics. Scopes: Topic scopes.

Before you start

Item	Required
`topics:create`	To create a topic
`topics:read`	To list

Auth: Authorization: Bearer sk_live_.... Base URL: https://api.notifique.dev.

1. In the dashboard

Audience → Topics → New
Name (Newsletter), slug (newsletter), description for the preferences link
Default opt-in for new contacts (optional)
In the MARKETING template, associate the correct topic

2. Create a topic (API)

POST /v1/topics
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx

{
  "name": "Newsletter",
  "slug": "newsletter",
  "description": "Company news and articles",
  "defaultOptIn": false
}

Expected response: 200 — save the id for segments and templates.

Once campaigns depend on the slug, avoid renaming it.

3. List topics

GET /v1/topics?page=1&limit=50
Authorization: Bearer sk_live_xxxxx

4. Segment “subscribed to topic”

{
  "version": 1,
  "match": "all",
  "rules": [
    { "type": "topic", "topicId": "clxxTopicNews", "subscribed": true },
    { "type": "receiveMarketing", "value": true }
  ]
}

5. Preferences link in email

On the contact record, generate the preferences link. In the template use {{preferences_link}} — the person chooses which topics they want to receive.

API E-mail

E-mail

Domínios

E-mails recebidos

Quick Start — Topics

In brief

Before you start

1. In the dashboard

2. Create a topic (API)

3. List topics

4. Segment “subscribed to topic”

5. Preferences link in email

Next steps

​In brief

​Before you start

​1. In the dashboard

​2. Create a topic (API)

​3. List topics

​4. Segment “subscribed to topic”

​5. Preferences link in email

​Next steps

In brief

Before you start

1. In the dashboard

2. Create a topic (API)

3. List topics

4. Segment “subscribed to topic”

5. Preferences link in email

Next steps