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

# Inicio rápido

> Cree un formulario, suscriba a alguien y (opcionalmente) confirme double opt-in.

<Tip>
  **Create** requiere `forms:manage`. **Subscribe** requiere `forms:submit`. Waitlist y newsletter son solo el `template` al crear, mismos endpoints.
</Tip>

## En resumen

* `POST /v1/forms/lists` crea el formulario
* `POST /v1/forms/subscriptions` registra un envío
* Página pública: `POST /w/forms/{id}/subscribe` (sin API Key)

Alcances: [Alcances de API Key](/es/marketing-addons-api/como-funciona/escopos-da-api-key).

***

## 1. Crear formulario

#### 1A, Panel

**Add-ons → Forms** → elija template (Waitlist, Newsletter, etc.) → personalice y publique.

#### 1B, API

Alcance: **`forms:manage`**.

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

Ejemplo waitlist:

```json theme={null}
{
  "name": "Early access 2026",
  "template": "WAITLIST",
  "features": {
    "queue": true,
    "doubleOptIn": false,
    "captureContact": true
  }
}
```

Templates: `BLANK`, `CONTACT`, `SURVEY`, `WAITLIST`, `NEWSLETTER`.

URL pública: `https://api.notifique.dev/w/forms/{id}`

***

## 2. Pausar o finalizar

```http theme={null}
PATCH /v1/forms/lists/{id}
Authorization: Bearer sk_live_xxxxx
```

```json theme={null}
{ "status": "PAUSED" }
```

Valores: `ACTIVE`, `PAUSED`, `CLOSED`, `ENDED`.

***

## 3. Listar formularios y suscripciones

```http theme={null}
GET /v1/forms/lists
Authorization: Bearer sk_live_xxxxx
```

```http theme={null}
GET /v1/forms/lists/{id}/subscriptions?status=CONFIRMED&page=1&limit=25
Authorization: Bearer sk_live_xxxxx
```

Alcance: **`forms:manage`**.

***

## 4. Suscribir a alguien

Alcance: **`forms:submit`**.

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

```json theme={null}
{
  "listId": "cmuxxxform",
  "email": "person@example.com",
  "name": "Maria",
  "answers": { "company": "Acme" }
}
```

***

## 5. Confirmar double opt-in

```http theme={null}
POST /v1/forms/subscriptions/confirm
Authorization: Bearer sk_live_xxxxx
```

```json theme={null}
{ "confirmationToken": "token_from_subscribe" }
```

Dispara webhook **`form.confirmed`**.

***

## 6. Cancelar suscripción (newsletter)

```http theme={null}
POST /v1/forms/subscriptions/{subscriptionId}/cancel
Authorization: Bearer sk_live_xxxxx
```

```json theme={null}
{ "source": "api" }
```

Dispara **`form.unsubscribed`**.

***

## Public subscribe (sin API Key)

```http theme={null}
POST /w/forms/{id}/subscribe
Content-Type: application/json
```

Body: campos del formulario + honeypot `website` vacío.

***

## Próximos pasos

* [Templates y casos de uso](/es/marketing-addons-api/como-funciona/templates-e-casos-de-uso)
* [Eventos de Webhook](/es/marketing-addons-api/como-funciona/eventos-do-webhooks)
* [Introducción](/es/marketing-addons-api/como-funciona/introducao)