Inicio rápido

Create requiere forms:manage. Subscribe requiere forms:submit. Waitlist y newsletter son solo el template al crear, mismos endpoints.

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.

1. Crear formulario

1A, Panel

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

1B, API

Alcance: forms:manage.

POST /v1/forms/lists
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx

Ejemplo waitlist:

{
  "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

PATCH /v1/forms/lists/{id}
Authorization: Bearer sk_live_xxxxx

{ "status": "PAUSED" }

Valores: ACTIVE, PAUSED, CLOSED, ENDED.

3. Listar formularios y suscripciones

GET /v1/forms/lists
Authorization: Bearer sk_live_xxxxx

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.

POST /v1/forms/subscriptions
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx

{
  "listId": "cmuxxxform",
  "email": "person@example.com",
  "name": "Maria",
  "answers": { "company": "Acme" }
}

5. Confirmar double opt-in

POST /v1/forms/subscriptions/confirm
Authorization: Bearer sk_live_xxxxx

{ "confirmationToken": "token_from_subscribe" }

Dispara webhook form.confirmed.

POST /v1/forms/subscriptions/{subscriptionId}/cancel
Authorization: Bearer sk_live_xxxxx

{ "source": "api" }

Dispara form.unsubscribed.

POST /w/forms/{id}/subscribe
Content-Type: application/json

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

Add-ons

Forms

Enlaces cortos

enlaces cortos

Conversiones (enlaces inteligentes)

En resumen

1. Crear formulario

1A, Panel

1B, API

2. Pausar o finalizar

3. Listar formularios y suscripciones

4. Suscribir a alguien

5. Confirmar double opt-in

Próximos pasos

​En resumen

​1. Crear formulario

​1A, Panel

​1B, API

​2. Pausar o finalizar

​3. Listar formularios y suscripciones

​4. Suscribir a alguien

​5. Confirmar double opt-in

​6. Cancelar suscripción (newsletter)

​Public subscribe (sin API Key)

​Próximos pasos

En resumen

1. Crear formulario

1A, Panel

1B, API

2. Pausar o finalizar

3. Listar formularios y suscripciones

4. Suscribir a alguien

5. Confirmar double opt-in

6. Cancelar suscripción (newsletter)

Public subscribe (sin API Key)

Próximos pasos