# Agenda

> Calendários usados nos agendamentos.

Endereço: https://docs.nextags.com.br/referencia/agenda/
Tipo: Referência

Os calendários do **Gestor de Agendamentos** (**Ferramentas** › **Gestor de Agendamentos**): o que o contato reserva pelo link do calendário, pelo fluxo ou pela IA. A API só lê os calendários; criar e editar um calendário e ver os agendamentos é na tela. Veja [Criar um calendário](https://help.nextags.com.br/tutoriais/agenda/criar-calendario/).

## Endpoints

- [Listar calendários](https://docs.nextags.com.br/referencia/agenda/listar-calendarios.md): `GET /calendars`
- [Consultar calendário](https://docs.nextags.com.br/referencia/agenda/consultar-calendario.md): `GET /calendars/{calendar_id}`

## O objeto: Calendário

| Campo | Tipo | Descrição |
|---|---|---|
| `id` | integer | O ID do calendário. |
| `name` | string | O nome do calendário. |
| `duration` | integer | A **Duração do evento**: quanto dura cada agendamento, em minutos (na tela, de 5 minutos a 23 horas). |
| `created_by` | integer | O ID do administrador que criou. |
| `created_at` | string (data e hora) | Quando o calendário foi criado, em UTC. |

```json
{
  "id": 8001,
  "name": "Avaliação gratuita",
  "duration": 30,
  "created_by": 10001,
  "created_at": "2026-08-01 12:00:00"
}
```