Get available webhook event types

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

GET
/v3/webhooks/event-types

Response Body

application/json

application/json

curl -X GET "https://example.com/v3/webhooks/event-types"
{
  "success": true,
  "data": {
    "event_types": [
      {
        "name": "message",
        "display_name": "Messages",
        "description": "Webhook events for message status changes",
        "is_active": true,
        "event_type": null,
        "sub_types": [
          {
            "name": "message.delivered",
            "display_name": "Message Delivered",
            "description": "Triggered when a message is confirmed delivered",
            "is_active": true,
            "event_type": "message",
            "sub_types": null
          },
          {
            "name": "message.failed",
            "display_name": "Message Failed",
            "description": "Triggered when a message delivery fails",
            "is_active": true,
            "event_type": "message",
            "sub_types": null
          }
        ]
      },
      {
        "name": "templates",
        "display_name": "Templates",
        "description": "Webhook events for template status changes",
        "is_active": true,
        "event_type": null,
        "sub_types": [
          {
            "name": "templates.approved",
            "display_name": "Template Approved",
            "description": "Triggered when a template is approved and can be sent",
            "is_active": true,
            "event_type": "templates",
            "sub_types": null
          },
          {
            "name": "templates.rejected",
            "display_name": "Template Rejected",
            "description": "Triggered when a template is rejected",
            "is_active": true,
            "event_type": "templates",
            "sub_types": null
          }
        ]
      },
      {
        "name": "contact",
        "display_name": "Contacts",
        "description": "Signals raised by a contact — opting out, opting back in, asking for help, or sending one of your own auto-reply keywords",
        "is_active": true,
        "event_type": null,
        "sub_types": [
          {
            "name": "contact.opt_in",
            "display_name": "Contact Opted In",
            "description": "Triggered when a contact opts back in to receiving messages, for example by texting START",
            "is_active": true,
            "event_type": "contact",
            "sub_types": null
          },
          {
            "name": "contact.opt_out",
            "display_name": "Contact Opted Out",
            "description": "Triggered when a contact opts out of receiving messages, for example by texting STOP",
            "is_active": true,
            "event_type": "contact",
            "sub_types": null
          },
          {
            "name": "contact.help",
            "display_name": "Contact Requested Help",
            "description": "Triggered when a contact asks for help, for example by texting HELP. Carries no consent change",
            "is_active": true,
            "event_type": "contact",
            "sub_types": null
          },
          {
            "name": "contact.custom_keyword",
            "display_name": "Contact Custom Keyword",
            "description": "Triggered when a contact sends one of your own auto-reply keywords, for example BOOKING. Read template_id to see which of your templates matched. Carries no consent change",
            "is_active": true,
            "event_type": "contact",
            "sub_types": null
          }
        ]
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 3,
      "total_count": 3,
      "total_pages": 1,
      "has_more": false,
      "cursors": null
    }
  },
  "error": null,
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-09-30T14:13:13.2060464+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/reference/api/error-catalog"
  },
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-09-30T14:13:13.2060486+00:00",
    "version": "v3"
  }
}