Localisé par IA

Créer un webhook

Créez un nouveau webhook dans votre espace de travail. Nécessite des permissions complètes. La validation d'URL inclut une protection SSRF — les adresses IP privées, localhost et les points de terminaison de métadonnées sont bloqués.

POST/webhooks
Copy

Corps de la requête

namestring Required
Link

Nom unique dans l'espace de travail.

urlstring Required
Link

URL du point de terminaison HTTPS (validée contre SSRF).

all_eventsboolean
Link

S'abonner à tous les types d'événements (par défaut : false).

enabledboolean
Link

Indique si le webhook est actif (par défaut : true).

eventsstring[]
Link

Tableau des noms de types d'événements auxquels s'abonner (par défaut : ). Ignoré si all_events est défini sur true.

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

const result = await response.json();

Réponses

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

Types d'événements disponibles

Voici tous les types d'événements qui peuvent être utilisés dans le tableau events :

Événements d'e-mail : email.accepted, email.scheduled, email.delivered, email.bounced, email.attempted, email.failed, email.rejected, email.clicked, email.loaded, email.complained, email.received, email.suppressed

Événements de domaine : domain.created, domain.updated, domain.deleted

Événements d'audience : audience.created, audience.updated, audience.deleted

Événements d'abonné : subscriber.created, subscriber.updated, subscriber.deleted

Événements de contact : contact.created, contact.updated, contact.deleted

Événements de modèle : template.created, template.updated, template.deleted

Événements de suppression : suppression.created, suppression.updated, suppression.deleted

Événements de vérification d'e-mail : email_verification.created, email_verification.updated

Événements de liste de vérification d'e-mail : email_verification_list.created, email_verification_list.updated