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

> From first tag to first contact: dashboard and API in the same flow.

<Tip>
  Suggested order: **tags and fields → contacts → topics → segments → campaigns**. A contact needs **phone or email** (or both).
</Tip>

## In short

* **Contact** = the person. **Tag** = label. **Topic** = consent per theme. **Segment** = saved filter. **Campaign** = batch send.
* Use the **API reference** on the Contacts tab for exact routes.

Context: [Introduction](/en/contacts-api/como-funciona/introducao). Scopes: [API Key scopes](/en/contacts-api/como-funciona/escopos-da-api-key).

## Before you start

* Key with scopes you need (`contacts:create`, `tags:create`, etc.)
* Auth: `Authorization: Bearer sk_live_...` or `x-api-key`
* Base URL: `https://api.notifique.dev`

***

## 1. Dashboard flow (first time)

#### 1A, Via dashboard

1. **Contacts → Tags**, create labels (`Lead`, `Customer`)
2. **Custom fields**, keys like `city`, `current_plan`
3. **Import** or manual entry, phone **or** email per row
4. **Audience → Topics**, marketing themes
5. **Audience → Segments**, saved filters → use **Preview**
6. **Audience → Campaigns**, template + channels + segment or IDs → **Run**

Guides: [Topics](/en/contacts-api/como-funciona/topicos-de-comunicacao) · [Segments](/en/contacts-api/como-funciona/segmentos-na-audiencia) · [Campaigns](/en/contacts-api/como-funciona/campanhas-no-painel).

***

## 2. Create tag (API)

Scope: **`tags:create`**.

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

```json theme={null}
{
  "name": "Lead"
}
```

Expected response: **200**, save the **`id`** for `tagIds` when creating contacts.

***

## 3. Create contact (API)

Scope: **`contacts:create`**.

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

```json theme={null}
{
  "phone": "5511999999999",
  "name": "John Silva",
  "email": "john@example.com",
  "telegramPeer": "123456789",
  "tagIds": ["clxxTag1"]
}
```

Expected response: **200** with contact `id`.

***

## 4. List contacts (API)

Scope: **`contacts:read`**.

```http theme={null}
GET /v1/contacts?page=1&limit=20&search=john
Authorization: Bearer sk_live_xxxxx
```

Optional filters: `search`, `tagId`.

***

## 5. Next API steps

| Goal                | Typical scope                                             | Guide                                                             |
| ------------------- | --------------------------------------------------------- | ----------------------------------------------------------------- |
| Marketing topics    | `topics:*`                                                | [Topics](/en/contacts-api/como-funciona/topicos-de-comunicacao)   |
| Rule-based audience | `segments:*`                                              | [Segments](/en/contacts-api/como-funciona/segmentos-na-audiencia) |
| Batch send          | `campaigns:create`, `campaigns:run` + channel send scopes | [Campaigns](/en/contacts-api/como-funciona/campanhas-no-painel)   |

***

## Next steps

* [Introduction](/en/contacts-api/como-funciona/introducao): concept map
* [Scopes](/en/contacts-api/como-funciona/escopos-da-api-key)
* [Templates](/en/template-api/como-funciona/quick-start): message used in campaigns