Agency Partners
Get an Agency Webhook
Reads one agency listener.
https://app.tryredrover.com/api/public/v1/agency/webhooks/{id}webhooks:readHeaders
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 listener.
dataobjectRequiredShow 9 Child FieldsHide Child Fields
idstringRequiredWebhook endpoint ID (UUID)
urlstringRequiredWhere we send events. Always https
descriptionstringRequiredYour note about the endpoint
nullable
enabledbooleanRequiredFalse when turned off, by you or after repeated failures
disabledReasonstringRequiredWhy we turned the endpoint off, when we did
nullable
createdAtstringRequiredISO 8601 datetime
updatedAtstringRequiredISO 8601 datetime
agencyIdstringRequiredYour agency's ID
eventsstring[]RequiredThe events it subscribes to, client and agency events included
each 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
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 "https://app.tryredrover.com/api/public/v1/agency/webhooks/5d2f8a1c-4b6e-4f3a-9d7c-1e8b2a6f0c93" \
-H "Authorization: Bearer $REDROVER_API_KEY"{
"data": {
"id": "5d2f8a1c-4b6e-4f3a-9d7c-1e8b2a6f0c93",
"agencyId": "6a1e3c5b-7d9f-4b2a-8c4e-0f2a4c6e8b1d",
"url": "https://agency.example.com/hooks/redrover",
"description": "Sync clients to our CRM",
"events": [
"client.created",
"client.updated",
"credits.low",
"post.posted"
],
"enabled": true,
"disabledReason": null,
"createdAt": "2026-11-16T10:00:00Z",
"updatedAt": "2026-11-16T10:00:00Z"
}
}