RedRover Logo

Agency Partners

Update an Agency Webhook

Changes a listener's URL, events or note, or turns it off or back on.

PATCH/agency/webhooks/{id}
Scope: webhooks:write

Headers

  • AuthorizationstringRequired

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

Path Parameters

Body

  • urlstring

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

    up to 2048 characters

  • eventsstring[]

    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. null clears it

    up to 200 characters · nullable

  • enabledboolean

    false turns the listener off; true turns it back on and clears its failure streak

Response

200 The listener after the change.

  • dataobjectRequired
    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.

  • 404No listener with this ID in your agency
  • 400A field is invalid
  • 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 PATCH "https://app.tryredrover.com/api/public/v1/agency/webhooks/5d2f8a1c-4b6e-4f3a-9d7c-1e8b2a6f0c93" \
  -H "Authorization: Bearer $REDROVER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "enabled": true
}'
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"
  }
}