> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start — Topics

> Create marketing themes, link them to templates, and filter audiences by consent.

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

## 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](/en/contacts-api/como-funciona/topicos-de-comunicacao). Scopes: [Topic scopes](/en/contacts-api/como-funciona/topicos-escopos-da-api-key).

## 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

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

***

## 2. Create a topic (API)

```http theme={null}
POST /v1/topics
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx
```

```json theme={null}
{
  "name": "Newsletter",
  "slug": "newsletter",
  "description": "Company news and articles",
  "defaultOptIn": false
}
```

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

<Warning>
  Once campaigns depend on the slug, **avoid renaming** it.
</Warning>

***

## 3. List topics

```http theme={null}
GET /v1/topics?page=1&limit=50
Authorization: Bearer sk_live_xxxxx
```

***

## 4. Segment "subscribed to topic"

```json theme={null}
{
  "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.

***

## Next steps

* [Campaigns](/en/contacts-api/como-funciona/campanhas-no-painel)
* [One-click unsubscribe](/en/emails-api/como-funciona/one-click-unsubscribe-rfc-8058)
* [Introduction](/en/contacts-api/como-funciona/introducao)