Skip to content

Webhooks

Test and resend

Send a test event

On an endpoint’s page, choose Send test event. Mestra sends a ping event to that endpoint straight away, signed like any other. You can send up to 10 a minute per endpoint, one at a time. Use it to check your URL and your signature check before real events arrive. A test event is tried once and isn’t retried.

JSON
{
"id": "evt_…",
"object": "event",
"type": "ping",
"created": "2026-10-22T03:14:15Z",
"data": {}
}

Read the delivery log

An endpoint’s page lists its deliveries, newest first. Each one shows the event type, the time, the status code or the kind of error (for example Timed out, DNS lookup failed, TLS error, Connection failed or Redirect not followed), how long it took and when the next retry is due. Open one to see the request body, the headers and the first part of your answer.

The Events tab lists every event from the last 30 days. Filter by type, and open an event to see its JSON and where it was delivered.

Events and delivery logs are kept for 30 days.

Resend

Choose Resend on a delivery or an event to send it again to one of your endpoints. Resend:

  • works for events up to 15 days old;
  • works even if the endpoint wasn’t subscribed to that type when the event happened;
  • sends the same event with the same id, signed afresh;
  • doesn’t cancel retries already waiting;
  • is tried once and isn’t retried, so choose Resend again if it fails;
  • is limited to 10 a minute per endpoint, and one at a time.

Because a resend repeats an id, your receiver should already ignore repeats.

List events from the API

Read the same events with a key:

Shell
curl -H "Authorization: Bearer $MESTRA_TOKEN" \
"https://app.withmestra.com/api/v1/events?type=run.completed&limit=20"
JSON
{
"events": [ { "id": "evt_…", "object": "event", "type": "run.completed", "created": "2026-10-22T03:14:15Z", "data": { "object": { "id": "…", "type": "run", "url": "https://app.withmestra.com/api/v1/runs/…" } } } ],
"next": "…"
}
Query Meaning
type Only this type. Repeat it for more than one.
before The next value from the last page, to get the next page.
limit Up to 100. The default is 50.

next is null on the last page. Treat the value as opaque: pass it back as before. Fetch one event with GET /api/v1/events/{id}.

A key sees only the types in permission areas it can read. The event types page lists the area for each. An agent connected over MCP can use the account.events op for the same list.

Use this to catch up after downtime: list events since you last heard from Mestra, then fetch what you need.