Webhook deliveries

Ready logs every POST it makes to your webhook, with what your endpoint answered. Use the log to find events your endpoint missed and send them again. Test keys can read the log but can’t resend (403 test_key_not_allowed).

#List webhook deliveries

Every POST Ready made to your webhook in the last 30 days, newest first: first tries, retries and resends, with the answer your endpoint gave. Test events are not listed. When your webhook takes your sub-accounts’ events, their copies are listed too. Needs the manage_integrations permission, because the bodies hold your contacts’ numbers and texts.

Query parameters

eventstring: Only this event, one of the webhook events.
resultenum: succeeded or failed.
sub_account_idstring: A sub-account’s id for its events only, or main for your own account’s.
qstring: Search the event id, event name, response code, error, sub-account name and body. A phone number in any format matches by its digits. Up to 200 characters.
limitintegerDefault 50: 1 to 100.
before_idinteger: The next page: pass the next_before_id of the last answer.

Returns

dataobject[]: One per POST: id, event_id (the X-Ready-Event-Id it carried), event, attempt, trigger (live, retry or resend), url, succeeded, response_code, error, duration_ms, sub_account ({ "id", "name" } or null) and created_at.
next_before_idinteger | null: Pass it as before_id for the next page. null on the last page.

Errors

HTTP	Code	When
400	`invalid_field`	A query value isn’t one listed above.
403	`permission_denied`	The key’s user lacks `manage_integrations`.

curl "https://api.tryready.com/settings/webhooks/deliveries?result=failed&limit=20" \
  -H "X-API-Key: $READY_API_KEY"

const res = await fetch('https://api.tryready.com/settings/webhooks/deliveries?result=failed&limit=20', {
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
  },
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.get(
    "https://api.tryready.com/settings/webhooks/deliveries?result=failed&limit=20",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')

Returns:

{
  "success": true,
  "data": [
    {
      "id": 88213,
      "event_id": "evt_3b0f6c2e-9a41-4d7e-8c55-1f2a7d9e0b64",
      "event": "inbound_reply",
      "attempt": 2,
      "trigger": "retry",
      "url": "https://you.example.com/ready-webhook",
      "succeeded": false,
      "response_code": 503,
      "error": null,
      "duration_ms": 412,
      "sub_account": null,
      "created_at": "2026-10-01T20:41:12.004Z"
    }
  ],
  "next_before_id": null
}

#Get a webhook delivery

One delivery from the list, with what Ready sent and what your endpoint answered. Needs the manage_integrations permission.

Returns

dataobject: The fields of a list item, plus request_headers, request_body (the exact body that was signed), response_body, and event_delivered: true once any try of this event succeeded.

Errors

HTTP	Code	When
404	`not_found`	No delivery with this id on your account.

curl "https://api.tryready.com/settings/webhooks/deliveries/88213" \
  -H "X-API-Key: $READY_API_KEY"

const res = await fetch('https://api.tryready.com/settings/webhooks/deliveries/88213', {
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
  },
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.get(
    "https://api.tryready.com/settings/webhooks/deliveries/88213",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')

#Resend a webhook delivery

Sends a failed event to your webhook again now, with the same body and the same X-Ready-Event-Id. Each call is one more try, listed as a new delivery. Takes no body. Needs the manage_integrations permission and a live key.

Returns

dataobject: id (the new delivery), attempt, event_id, succeeded, response_code, duration_ms and error. A failed resend still answers 200 with succeeded: false. A resend sends the original body, so its timestamp is the original event time: a receiver that rejects old timestamps must allow up to 30 days, and should drop repeats by X-Ready-Event-Id instead.

Errors

HTTP	Code	When
404	`not_found`	No delivery with this id on your account.
409	`delivery_succeeded`	The event already got through.
409	`retry_pending`	Ready is still retrying it on its own. Wait for that retry.
409	`webhook_not_set`	No webhook URL is saved. Save one with `PUT /v1/webhooks`, then resend.
409	`webhook_off`	Your webhook is off (`enabled: false`). Turn it on with `PUT /v1/webhooks` and `"enabled": true`, then resend.
409	`event_off`	Your webhook no longer takes this event. Add it to `events` with `PUT /v1/webhooks`, then resend.
429	`rate_limited`	Too many resends at once. Wait and try again.

curl -X POST "https://api.tryready.com/settings/webhooks/deliveries/88213/resend" \
  -H "X-API-Key: $READY_API_KEY"

const res = await fetch('https://api.tryready.com/settings/webhooks/deliveries/88213/resend', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
  },
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.post(
    "https://api.tryready.com/settings/webhooks/deliveries/88213/resend",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')

Returns:

{
  "success": true,
  "data": {
    "id": 88240,
    "attempt": 3,
    "event_id": "evt_3b0f6c2e-9a41-4d7e-8c55-1f2a7d9e0b64",
    "succeeded": true,
    "response_code": 200,
    "duration_ms": 186,
    "error": null
  }
}