Skip to main content
PUT
/
api
/
public
/
v2
/
webhooks
curl --location --request PUT 'https://www.headout.com/api/public/v2/webhooks/' \
--header 'Headout-Auth: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
  "url": "https://new-domain.com/webhooks/headout/booking-status",
  "enabled": true
}'

{
  "timestamp": 1756977149760,
  "message": "Webhook configuration updated successfully"
}
Update your existing webhook configuration 
curl --location --request PUT 'https://www.headout.com/api/public/v2/webhooks/' \
--header 'Headout-Auth: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
  "url": "https://new-domain.com/webhooks/headout/booking-status",
  "enabled": true
}'

{
  "timestamp": 1756977149760,
  "message": "Webhook configuration updated successfully"
}

Authorizations

​
Headout-Auth
string
header
required

Body

application/json
​
url
string<uri>
required

HTTPS URL where webhooks will be delivered (must use HTTPS)

Pattern: ^https://.*
​
enabled
boolean
default:true

Whether the webhook is active

Response

Webhook configuration updated successfully

​
timestamp
integer<int64>

Response timestamp in milliseconds

​
message
string | null

Response message

​
error
object
​
data
object

Response data payload