API Reference

Retrieve Event

GET /events/:id — one event definition, by id or by name.

GET/events/:id

Reads one event definition: the event name your automations trigger on and the schema of its fields. Pass the definition's id or the event name itself, such as user.created.

Needs an API key with read access.
Path parameters
idstringrequired

The event definition id, or the event name (URL-encoded).

const res = await fetch('https://www.senddart.com/api/events/user.created', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer mb_xxxxxxxxx' },
});
const data = await res.json();
console.log(data);

Response

{
  "object": "event",
  "id": "b6d24b8e-af0b-4c3c-be0c-359bbd97381e",
  "name": "user.created",
  "schema": {
    "plan": "string"
  },
  "created_at": "2026-06-23T10:00:00.000Z",
  "updated_at": "2026-06-23T10:00:00.000Z"
}

No definition with that id or name returns 404 not_found.