Localizzato tramite IA

Crea Webhook

Crea un nuovo webhook nel tuo workspace. Richiede permessi completi. La validazione dell'URL include protezione SSRF — IP privati, localhost ed endpoint di metadati sono bloccati.

POST/webhooks
Copy

Corpo della Richiesta

namestring Required
Link

Nome univoco all'interno del workspace.

urlstring Required
Link

URL endpoint HTTPS (validato contro SSRF).

all_eventsboolean
Link

Sottoscrivi tutti i tipi di evento (predefinito: false).

enabledboolean
Link

Se il webhook è attivo (predefinito: true).

eventsstring[]
Link

Array di nomi dei tipi di evento a cui sottoscriversi (predefinito: ). Ignorato se all_events è true.

Crea 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 Produzione',
    url: 'https://example.com/webhook',
    all_events: false,
    enabled: true,
    events: ['email.accepted', 'email.delivered', 'email.bounced']
  })
});

const result = await response.json();

Risposte

{
  "object": "webhook",
  "id": "wh_2BxFg7KNqr5M...",
  "name": "Webhook Produzione",
  "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"
}

Tipi di Evento Disponibili

Questi sono tutti i tipi di evento che possono essere utilizzati nell'array events:

Eventi 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

Eventi dominio: domain.created, domain.updated, domain.deleted

Eventi pubblico: audience.created, audience.updated, audience.deleted

Eventi iscritto: subscriber.created, subscriber.updated, subscriber.deleted

Eventi contatto: contact.created, contact.updated, contact.deleted

Eventi template: template.created, template.updated, template.deleted

Eventi soppressione: suppression.created, suppression.updated, suppression.deleted

Eventi verifica email: email_verification.created, email_verification.updated

Eventi lista verifica email: email_verification_list.created, email_verification_list.updated