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

> Set up audience, template, and channel; send or schedule a campaign.

<Tip>
  A **campaign** is a bulk send to a **segment** (or list) with a defined **template** and **channel**.
</Tip>

## In brief

* **Prepare** segment, template, and channel instance.
* **Create** the campaign in the dashboard or with `POST /v1/campaigns`.
* **Send** immediately or scheduled; monitor status and metrics.

Context: [Campaigns in the dashboard](/en/contacts-api/como-funciona/campanhas-no-painel). Scopes: [Campaign scopes](/en/contacts-api/como-funciona/campanhas-escopos-da-api-key).

## Before you start

| Item                    | Required                     |
| ----------------------- | ---------------------------- |
| Segment or contact list | Audience                     |
| Approved template       | Content                      |
| Connected instance      | Channel (email, WhatsApp, …) |
| **`campaigns:create`**  | To create via API            |

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

***

## 1. In the dashboard

1. **Campaigns → New**
2. Internal name
3. **Audience**: segment (recommended) or manual selection
4. **Channel** + instance
5. **Template** (MARKETING category requires a topic)
6. **Send**: now or date/time
7. Review preview and confirm

The dashboard shows progress, deliveries, and errors per contact.

***

## 2. Create a campaign (API)

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

```json theme={null}
{
  "name": "March newsletter",
  "segmentId": "clxxSegmentId",
  "channel": "email",
  "instanceId": "clxxInstanceEmail",
  "templateId": "clxxTemplateId",
  "sendAt": null
}
```

`sendAt` in ISO 8601 to schedule; `null` or omitted for immediate send (per API).

***

## 3. Query a campaign

```http theme={null}
GET /v1/campaigns/{campaignId}
Authorization: Bearer sk_live_xxxxx
```

***

## 4. List campaigns

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

***

## Best practices

* Use **segments** instead of static lists when the audience changes over time.
* **MARKETING** templates: associate a **topic** and respect `receiveMarketing`.
* Test with a small segment or sandbox before the full send.
* Check **suppressions** — suppressed contacts do not receive.

***

## Next steps

* [Segments — Quick Start](/en/contacts-api/como-funciona/segmentos-quick-start)
* [Suppressions — introduction](/en/suppressions-api/como-funciona/introducao)
* [Introduction — Contacts](/en/contacts-api/como-funciona/introducao)