Event Types Reference

Complete reference of all event types across do.dev services

Every API action that produces a meaningful outcome generates an event. Here is the complete list of event types, organized by service.

Send Events

Events from the Send API (email delivery platform).

Event Type	Description
`send.email.sent`	Email accepted for delivery
`send.email.delivered`	Email successfully delivered to recipient
`send.email.bounced`	Email bounced (hard or soft bounce)
`send.email.complained`	Recipient filed a spam complaint
`send.email.opened`	Recipient opened the email (tracking pixel loaded)
`send.email.clicked`	Recipient clicked a link in the email
`send.domain.verified`	Sending domain DNS verification completed
`send.suppression.added`	Email address added to suppression list

send.email.sent

Fired when an email is accepted for delivery.

{
  "eventId": "evt_...",
  "type": "send.email.sent",
  "service": "send",
  "data": {
    "messageId": "msg_abc123",
    "from": "hello@mail.example.com",
    "to": ["user@example.com"],
    "subject": "Welcome to our platform"
  },
  "createdAt": 1700000000000
}

send.email.bounced

Fired when an email delivery fails.

{
  "eventId": "evt_...",
  "type": "send.email.bounced",
  "service": "send",
  "data": {
    "messageId": "msg_abc123",
    "to": "user@example.com",
    "bounceType": "hard",
    "diagnosticCode": "550 5.1.1 User unknown"
  },
  "createdAt": 1700000000000
}

Telco Events

Events from the Telco API (phone number intelligence).

Event Type	Description
`telco.lookup.completed`	Phone number lookup completed
`telco.search.completed`	Number search query completed

telco.lookup.completed

{
  "eventId": "evt_...",
  "type": "telco.lookup.completed",
  "service": "telco",
  "data": {
    "tn": "2125551234",
    "npa": "212",
    "nxx": "555",
    "hasCarrier": true,
    "hasInventory": false
  },
  "createdAt": 1700000000000
}

telco.search.completed

{
  "eventId": "evt_...",
  "type": "telco.search.completed",
  "service": "telco",
  "data": {
    "source": "npanxx",
    "filters": {
      "state": "NY",
      "npa": "212"
    }
  },
  "createdAt": 1700000000000
}

Talk Events

Events from the Talk API (text-to-speech).

Event Type	Description
`talk.speech.generated`	Text-to-speech audio generated

talk.speech.generated

{
  "eventId": "evt_...",
  "type": "talk.speech.generated",
  "service": "talk",
  "data": {
    "voice": "asteria",
    "format": "mp3",
    "textLength": 256,
    "speed": 1.0
  },
  "createdAt": 1700000000000
}

VoIP Events

Events from the VoIP service (voice calls).

Event Type	Description
`voip.call.incoming`	Incoming call received
`voip.call.completed`	Call ended normally
`voip.call.missed`	Unanswered incoming call

Transcribe Events

Events from the Transcribe service (speech-to-text).

Event Type	Description
`transcribe.session.completed`	Transcription session completed

Platform Events

System-level events from the do.dev platform itself.

Event Type	Description
`platform.key.created`	New API key created
`platform.key.revoked`	API key revoked
`platform.test`	Test event (from webhook test button)

platform.test

Sent when you use the test endpoint or the "Test Webhook" button in the dashboard.

{
  "eventId": "evt_...",
  "type": "platform.test",
  "service": "platform",
  "data": {
    "message": "This is a test webhook event from do.dev",
    "endpoint_id": "whep_abc123"
  },
  "livemode": false,
  "createdAt": 1700000000000
}

Wildcard Filters

When configuring webhook endpoints, you can use wildcard patterns to subscribe to groups of events:

Pattern	Matches
`*`	Every event from every service
`send.*`	All send events
`send.email.*`	All send email events (sent, delivered, bounced, etc.)
`telco.*`	All telco events
`send.email.bounced`	Only this specific event type

Example: Monitor delivery issues

{
  "url": "https://example.com/webhooks/alerts",
  "enabled_events": [
    "send.email.bounced",
    "send.email.complained"
  ]
}

Example: Full visibility

{
  "url": "https://example.com/webhooks/all",
  "enabled_events": ["*"]
}