Webhooks
Create a Webhook Endpoint
Adds an endpoint that gets the events you pick, and returns its signing secret once.
https://app.tryredrover.com/api/public/v1/webhookswebhooks:writeStore secret right away: it is only in this response. Use it to verify each request.
A workspace can have up to 10 endpoints. Webhooks need an API key; connected AI apps cannot manage them.
Headers
AuthorizationstringRequiredBearerfollowed by anrr_live_API key or a connected app's access token. See Authentication.X-Workspace-IdstringRequiredThe workspace to act on, from List Workspaces.
UUID
Body
urlstringRequiredWhere we send events. Must be https and reach the public internet; private, loopback and cloud metadata addresses are refused
up to 2048 characters
eventsstring[]RequiredThe events to send, like
post.posted. See Webhooks for the full listat 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
descriptionstringYour own note, up to 200 characters. null clears it
up to 200 characters · nullable
Response
201 The new endpoint with its signing secret.
dataobjectRequiredShow 10 Child FieldsHide Child Fields
idstringRequiredWebhook endpoint ID (UUID)
workspaceIdstringRequiredThe workspace whose events it gets
urlstringRequiredWhere we send events. Always https
descriptionstringRequiredYour note about the endpoint
nullable
eventsstring[]RequiredThe events it subscribes to
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
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
secretstringRequiredThe signing secret. Shown only in this response, so store it now
Errors
Every error uses the error envelope.
400url is not https, cannot be found, or points to a private address400events is empty or names an unknown event409The workspace already has 10 endpoints401The 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/webhooks" \
-H "Authorization: Bearer $REDROVER_API_KEY" \
-H "X-Workspace-Id: $REDROVER_WORKSPACE_ID" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/hooks/redrover",
"events": [
"post.posted",
"post.failed",
"comment.posted"
],
"description": "Post updates to our team channel"
}'{
"data": {
"id": "5d2f8a1c-4b6e-4f3a-9d7c-1e8b2a6f0c93",
"workspaceId": "8f14e45f-ceea-4e1a-9c2b-6d7a1c3b9e21",
"url": "https://example.com/hooks/redrover",
"description": "Post updates to our team channel",
"events": [
"post.posted",
"post.failed",
"comment.posted"
],
"enabled": true,
"disabledReason": null,
"createdAt": "2026-11-15T10:00:00Z",
"updatedAt": "2026-11-15T10:00:00Z",
"secret": "whsec_3f9a1c7e5b2d8f4a6c0e9b1d7f3a5c8e2b4d6f8a0c1e3b5d7f9a2c4e6b8d0f1a"
}
}