webhook.read

Requests received by a webhook.create inbox: method, path, query, headers and body, oldest first.

NetworkLater set1 unit per callnot cachedMCP: webhook_readv1.0.0

When to use it

Use after webhook.create to collect what was sent to the inbox URL. Pass wait_s to block until the next request arrives instead of polling in a loop, and pass the previous next_since as since to get only new requests.

Input

Field	Type	Description
`id` *	`string (≤ 32 chars)`	Inbox id from webhook.create. The id "demo" with token "demo" returns a fixed sample.
`token` *	`string (1+ chars, ≤ 64 chars)`	Read token from webhook.create.
`since`	`integer (≥ 0, ≤ 9007199254740991)`	Return requests after this sequence number. Use next_since from the last read. Default: 0.
`limit`	`integer (≥ 1, ≤ 50)`	Default: 20.
`wait_s`	`integer (≥ 0, ≤ 25)`	When nothing new has arrived, wait up to this many seconds for a request before answering. Default: 0.

* required

Output

Returns data with: requests: [{seq, received_at, method, path, query, headers, content_type, body, body_encoding, body_bytes}], next_since, has_more, total_received, expires_at.

Request

curl -X POST https://agentops.tools/v1/webhook.read \
  -H 'content-type: application/json' \
  -d '{"id":"demo","token":"demo"}'

Over MCP the tool is named webhook_read. Over A2A its skill id is webhook.read. Same input, same envelope.

Try it

Input (JSON)

Counts against your rate limit.

Sources

agentops.tools webhook inbox

Notes

body_encoding is base64 when the body is not valid UTF-8 text.
Cookies and headers added by the network are not recorded.