Agency Partners
Send a Test Event to an Agency Webhook
Sends a webhook.test event right away and returns how it went.
https://app.tryredrover.com/api/public/v1/agency/webhooks/{id}/testwebhooks:writeHeaders
AuthorizationstringRequiredBearerfollowed by anrr_live_API key or a connected app's access token. See Authentication.
Path Parameters
idstringRequiredThe listener ID from List Agency Webhooks
Response
200 The test delivery.
dataobjectRequiredShow 11 Child FieldsHide Child Fields
idstringRequiredDelivery ID, sent as RedRover-Delivery-Id
eventIdstringRequiredEvent ID, the payload's id
eventTypestringRequiredThe event type
one of post.scheduled, post.posted, post.failed, post.needs_approval, post.cancelled, comment.scheduled, comment.posted, comment.failed, comment.needs_approval, comment.cancelled, review.note_added, client.created, client.updated, credits.low, client.cap_reached, webhook.test
statusstringRequiredpending while retries remain
one of pending, succeeded, failed
attemptsintegerRequiredAttempts made so far
responseStatusintegerRequiredThe HTTP status your endpoint answered on the last attempt
nullable
errorstringRequiredWhat went wrong on the last attempt
nullable
durationMsintegerRequiredHow long the last attempt took
nullable
createdAtstringRequiredISO 8601 datetime
lastAttemptAtstringRequiredISO 8601 datetime
nullable
nextAttemptAtstringRequiredWhen the next retry is due, while pending
nullable
Errors
Every error uses the error envelope.
404No listener with this ID in your agency401The Authorization header is missing, or the key is invalid or revoked403The key lacks the endpoint's scope, or cannot reach the workspace429More than 120 requests in a minute. Wait for Retry-After seconds500Something went wrong on our side
curl -X POST "https://app.tryredrover.com/api/public/v1/agency/webhooks/5d2f8a1c-4b6e-4f3a-9d7c-1e8b2a6f0c93/test" \
-H "Authorization: Bearer $REDROVER_API_KEY"{
"data": {
"id": "0c4e8a2f-6b1d-4e3a-a5c7-9f2b4d6e8a1c",
"eventId": "e7a1c3f5-2b4d-4c6e-8f0a-1b3d5f7a9c2e",
"eventType": "webhook.test",
"status": "succeeded",
"attempts": 1,
"responseStatus": 200,
"error": null,
"durationMs": 184,
"createdAt": "2026-11-15T15:01:04Z",
"lastAttemptAt": "2026-11-15T15:01:05Z",
"nextAttemptAt": null
}
}