API Reference
Retrieve Event
GET /events/:id — one event definition, by id or by name.
GET
/events/:idReads 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
idstringrequiredThe 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.