Localizado por IA

Crear Webhook

Crea un nuevo webhook en tu espacio de trabajo. Requiere permisos completos. La validación de URL incluye protección SSRF: se bloquean IPs privadas, localhost y endpoints de metadatos.

POST/webhooks
Copy

Cuerpo de la Solicitud

namestring Required
Link

Nombre único dentro del espacio de trabajo.

urlstring Required
Link

URL del endpoint HTTPS (validada contra SSRF).

all_eventsboolean
Link

Suscribirse a todos los tipos de eventos (por defecto: false).

enabledboolean
Link

Si el webhook está activo (por defecto: true).

eventsstring[]
Link

Array de nombres de tipos de eventos a los que suscribirse (por defecto: ). Se ignora si all_events es true.

Crear webhook

const response = await fetch('https://api.emailit.com/v2/webhooks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer em_test_51RxCWJ...vS00p61e0qRE',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Webhook de Producción',
    url: 'https://example.com/webhook',
    all_events: false,
    enabled: true,
    events: ['email.accepted', 'email.delivered', 'email.bounced']
  })
});

const result = await response.json();

Respuestas

{
  "object": "webhook",
  "id": "wh_2BxFg7KNqr5M...",
  "name": "Webhook de Producción",
  "url": "https://example.com/webhook",
  "all_events": false,
  "enabled": true,
  "events": ["email.accepted", "email.delivered", "email.bounced"],
  "last_used_at": null,
  "created_at": "2026-02-10T10:00:00.000000+00:00",
  "updated_at": "2026-02-10T10:00:00.000000+00:00"
}

Tipos de Eventos Disponibles

Estos son todos los tipos de eventos que se pueden usar en el array events:

Eventos de email: email.accepted, email.scheduled, email.delivered, email.bounced, email.attempted, email.failed, email.rejected, email.clicked, email.loaded, email.complained, email.received, email.suppressed

Eventos de dominio: domain.created, domain.updated, domain.deleted

Eventos de audiencia: audience.created, audience.updated, audience.deleted

Eventos de suscriptor: subscriber.created, subscriber.updated, subscriber.deleted

Eventos de contacto: contact.created, contact.updated, contact.deleted

Eventos de plantilla: template.created, template.updated, template.deleted

Eventos de supresión: suppression.created, suppression.updated, suppression.deleted

Eventos de verificación de email: email_verification.created, email_verification.updated

Eventos de lista de verificación de email: email_verification_list.created, email_verification_list.updated