Get available webhook event types

Retrieves all available webhook event types that can be subscribed to.

GET
/v3/webhooks/event-types

Header Parameters

x-profile-id?string

Profile UUID to scope the request to a child profile. Only organization API keys can use this header. The profile must belong to the calling organization.

Formatuuid

Response Body

application/json

application/json

curl -X GET "https://api.sent.dm/v3/webhooks/event-types"
{
  "success": true,
  "data": {
    "event_types": [
      {
        "name": "message.sent",
        "display_name": "Message Sent",
        "description": "Triggered when a message is successfully sent",
        "is_active": true
      },
      {
        "name": "message.delivered",
        "display_name": "Message Delivered",
        "description": "Triggered when a message is confirmed delivered",
        "is_active": true
      },
      {
        "name": "message.failed",
        "display_name": "Message Failed",
        "description": "Triggered when a message delivery fails",
        "is_active": true
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-03-11T21:50:49.6760886+00:00",
    "version": "v3"
  }
}
Empty
Empty
{
  "success": false,
  "data": null,
  "error": {
    "code": "INTERNAL_001",
    "message": "An unexpected error occurred while retrieving event types",
    "details": null,
    "doc_url": "https://docs.sent.dm/errors/INTERNAL_001"
  },
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-03-11T21:50:49.6760913+00:00",
    "version": "v3"
  }
}

Get webhook events GET

Retrieves a paginated list of delivery events for the specified webhook.

Get authenticated account GET

Returns the account associated with the provided API key. The response includes account identity, contact information, messaging channel configuration, and — depending on the account type — either a list of child profiles or the profile's own settings. **Account types:** - `organization` — Has child profiles. The `profiles` array is populated. - `user` — Standalone account with no profiles. - `profile` — Child of an organization. Includes `organization_id`, `short_name`, `status`, and `settings`. **Channels:** The `channels` object always includes `sms`, `whatsapp`, and `rcs`. Each channel has a `configured` boolean. Configured channels expose additional details such as `phone_number`.