Update a webhook subscription

PUT /api/v2/webhook-subscriptions/{uuid}

Personal access token & O auth2

Headers

X-PLANNR-ACCOUNT-UUID string

Path parameters

uuid string Required
id string Required

Optional parameter. The UUID of the Webhook Subscription

application/json

Body Required

events array[string] Required

The events the webhook subscription is subscribed to. The available events are: account.created, account.updated, account.deleted, account.annual-review-date-occurred, circle.created, circle.updated, circle.deleted, plan.created, plan.updated, plan.deleted, case.created, case.updated, case.deleted, task.created, task.updated, task.deleted, task.completed, fact-find.completed and form-submission.completed

Responses

200 application/json
Hide response attributes Show response attributes object
- uuid string
  
  The UUID of the resource.
- created_at string
  
  The timestamp of when the resource was created.
- updated_at string
  
  The timestamp of when the resource was updated.
- signing_secret string
  
  The signing secret of the webhook. You can use this to create your own signature of the webhook body and compare it against the X-Signature header Plannr sends. This ensures that the payload has not been modified.
- url string
  
  The URL of the webhook Plannr will send events to.
- events array[string]
  
  The events the webhook subscription is subscribed to.
- last_outgoing_webhook_call_at string
  
  The last time Plannr sent a request to this webhook.

PUT /api/v2/webhook-subscriptions/{uuid}

curl \
 --request PUT 'https://api.plannrcrm.com/api/v2/webhook-subscriptions/6ff8f7f6-1eb3-3525-be4a-3932c805afed' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"events":["account.deleted","circle.created"]}'

Request examples

# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "events": [
    "account.deleted",
    "circle.created"
  ]
}

Response examples (200)

{
  "url": "https://api.example.com/webhooks",
  "uuid": "dea7ec52-818a-4013-b9b8-d916b6c37169",
  "events": [
    "account.deleted",
    "circle.created"
  ],
  "created_at": "2025-07-24T10:37:53+01:00",
  "updated_at": "2025-07-24T10:37:53+01:00",
  "signing_secret": "ZvdQzCIFeH0Z6j9CcCRjs6NYl3VEO9jwABVXZNFn4eFWlzk4limBzR7OEVsR",
  "last_outgoing_webhook_call_at": "2025-07-24T10:37:53+01:00"
}