RedRover Logo

Agency Partners

List Agency Webhooks

Lists your agency's listeners, which get events for every client.

GET/agency/webhooks
Scope: webhooks:read

Needs a partner key; any other key or a connected AI app gets 403.

Headers

  • AuthorizationstringRequired

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

Response

200 Every agency listener. Secrets are never returned.

  • dataobject[]Required
    Show 9 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

Errors

Every error uses the error envelope.

  • 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 "https://app.tryredrover.com/api/public/v1/agency/webhooks" \
  -H "Authorization: Bearer $REDROVER_API_KEY"
200 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"
    }
  ]
}