Send a test delivery
Queue a ping delivery so you can prove your receiver end to end. It travels the same path as a real event: same headers, same envelope, same signature, same retry ladder. The request counts as 1 call; the ping delivery itself is free. The response confirms the delivery was queued, not that it arrived, and the queue is swept every 30 seconds. Answers 404 NOT_FOUND for an unknown id.
Counted: 1 call when the request succeeds; refusals and errors are free. Needs SchedulesMCP connected to your account. The event deliveries we send are free. See how calls are counted.
Path parameters
Endpoint id.
Response schema
4 fields
Derived from the example response, nested as the JSON is.
Whether the request succeeded.
data
The payload. Everything an endpoint returns sits under this key.
Stable identifier for the record. On the tracking endpoints this is the container UUID, except on a portfolio summary row, where it is the container number.
True when the test event was accepted for delivery. It confirms the queue took it, not that your endpoint answered.
Errors
Every refusal is { "ok": false, "error": { "code", "message" } }. Branch on the code, and log the message. No refusal or error is counted as a call.
No endpoint with this id on your account. Not counted.
The key is missing, unknown, revoked or past its own expiry date. Not counted.
SchedulesMCP is not connected to your account, or its access period has ended. Not counted.
The monthly call limit or the key's daily limit is spent. Retry-After gives the seconds until it resets. Not counted.
Too many requests in a short window. Wait Retry-After seconds. Not counted.
curl -X POST 'https://api.schedulesmcp.com/v1/webhooks/3f1c9a4e-7b52-4f0e-9a41-2c9d5e6b8a10/test' \
-H "Authorization: Bearer smcp_YOUR_API_KEY"const res = await fetch("https://api.schedulesmcp.com/v1/webhooks/3f1c9a4e-7b52-4f0e-9a41-2c9d5e6b8a10/test", {
method: "POST",
headers: {
"Authorization": "Bearer smcp_YOUR_API_KEY"
}
});
const data = await res.json();import requests
res = requests.post(
"https://api.schedulesmcp.com/v1/webhooks/3f1c9a4e-7b52-4f0e-9a41-2c9d5e6b8a10/test",
headers={"Authorization": "Bearer smcp_YOUR_API_KEY"},
)
data = res.json(){
"ok": true,
"data": { "id": "3f1c9a4e-7b52-4f0e-9a41-2c9d5e6b8a10", "test_queued": true }
}