Skip to content

Update a webhook subscription

Request

Updates an existing webhook subscription configuration

Security
api_key
Bodyapplication/jsonrequired
topicstringrequired

The subscription topic to update.

Enum:"customer.joined.paid_tier""customer.joined.free_tier""customer.joined.free_trial""customer.joined.lifetime_tier""customer.changed_tier""customer.ordered""customer.payment_succeeded""customer.payment_failed""customer_billing.attempt.failed""customer.credits.updated"
Example:"customer.joined.paid_tier"
callbackUrlstring

The callback URL that will be called when one of the webhooks is triggered.

namestring

The subscription name.

idstringrequired

The subscription ID.

curl -i -X PUT \
  https://public.inveterateapi.com/v2.0/admin/webhook-subscriptions \
  -H 'Content-Type: application/json' \
  -H 'X-Inveterate-Api-Key: YOUR_API_KEY_HERE' \
  -d '{
    "topic": "customer.joined.paid_tier",
    "callbackUrl": "string",
    "name": "string",
    "id": "string"
  }'

Responses

Returned upon successful direct action to our database. Action is immediate.

Bodyapplication/json
messagestringrequired

The message associated with the response. Generally, the message only confirms the requested action. In the case of errors, the message will give insight into the source of the error.

dataobjectrequired

The data associated with the response. Data is only returned from errors if the error originates from our backend to give further insight into the nature of the error.

Response
{ "message": "Success", "data": { "id": 1, "name": "John Doe" } }