RedRover Logo

Agency Partners

Create an Agency Webhook

Adds a listener for all your clients' events, and returns its signing secret once.

POST/agency/webhooks
Scope: webhooks:write

Needs 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

  • AuthorizationstringRequired

    Bearer followed by an rr_live_ API key or a connected app's access token. See Authentication.

Body

  • urlstringRequired

    Where we send events. Must be https and reach the public internet

    up to 2048 characters

  • eventsstring[]Required

    The 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

  • descriptionstring

    Your own note, up to 200 characters

    up to 200 characters · nullable

Response

201 The new listener with its signing secret.

  • dataobjectRequired
    Show 10 Child Fields
    • idstringRequired

      Webhook endpoint ID (UUID)

    • urlstringRequired

      Where we send events. Always https

    • descriptionstringRequired

      Your note about the endpoint

      nullable

    • enabledbooleanRequired

      False when turned off, by you or after repeated failures

    • disabledReasonstringRequired

      Why we turned the endpoint off, when we did

      nullable

    • createdAtstringRequired

      ISO 8601 datetime

    • updatedAtstringRequired

      ISO 8601 datetime

    • agencyIdstringRequired

      Your agency's ID

    • eventsstring[]Required

      The 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

    • secretstringRequired

      The 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 invalid
  • 409Your agency already has 10 listeners
  • 401The Authorization header is missing, or the key is invalid or revoked
  • 403The key lacks the endpoint's scope, or cannot reach the workspace
  • 429More than 120 requests in a minute. Wait for Retry-After seconds
  • 500Something 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"
}'
201 Response
{
  "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"
  }
}