# Campanhas

> Agrupe links em campanhas e veja as métricas somadas: cliques, cidades, canais e conversões da campanha inteira.

Fonte: https://curtei.com/docs/api/campanhas

Endpoint: `POST https://api.curtei.com/v1/campaigns`
Escopo: `links:write`

```bash
curl -X POST https://api.curtei.com/v1/campaigns \
  -H "Authorization: Bearer $CURTEI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Black Friday 2026", "color": "amber"}'
```

- `name` até 80 caracteres, único na conta. `color`: `blue`, `green`, `amber`, `red`, `purple`, `pink`, `teal` ou `gray`.
- Vincule links com `campaign_id` no `POST`/`PATCH /links`.
- Métricas: `/stats`, `/stats/timeseries`, `/stats/breakdown`, `/stats/top-links` e `/stats/insights` aceitam `campaign_id`.
- `PATCH /campaigns/{id}` com `"archived": true` arquiva. `DELETE` apaga a campanha; os links continuam.
- Até 200 campanhas por conta. Leitura com `links:read`.