Agency Partners
Create an Agency Webhook
Adds a listener for all your clients' events, and returns its signing secret once.
https://app.tryredrover.com/api/public/v1/agency/webhookswebhooks:writeNeeds a partner key; any other key or a connected AI app gets 403.
Your agency can have up to 10 listeners. Each event names the client in client (its ID and your reference). See Agency Partners.
Headers
AuthorizationstringRequiredBearerfollowed by anrr_live_API key or a connected app's access token. See Authentication.
Body
urlstringRequiredWhere we send events. Must be https and reach the public internet
up to 2048 characters
eventsstring[]RequiredThe events to send: any content event, plus client.created, client.updated, credits.low and client.cap_reached
at least 1 items · 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
descriptionstringYour own note, up to 200 characters
up to 200 characters · nullable
Response
201 The new listener with its signing secret.
dataobjectRequiredShow 10 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
secretstringRequiredThe signing secret. Shown only in this response, so store it now
Errors
Every error uses the error envelope.
400url is not https or points to a private address, or events is invalid409Your agency already has 10 listeners401The 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" \
-H "Authorization: Bearer $REDROVER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://agency.example.com/hooks/redrover",
"events": [
"client.created",
"client.updated",
"credits.low",
"post.posted"
],
"description": "Sync clients to our CRM"
}'{
"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",
"secret": "whsec_3f9a1c7e5b2d8f4a6c0e9b1d7f3a5c8e2b4d6f8a0c1e3b5d7f9a2c4e6b8d0f1a"
}
}