Skip to main content

Update an endpoint

Availability pending. Check applicability.

Object and complete fields · Authentication, amounts and errors · Integration guide

PATCH /v1/webhook-endpoints/{id}

Updates the receiver URL or enable state. Omitted fields retain their values. The signing secret does not change.

Attributes​

AttributeLocationTypeRequiredDescription
Idempotency-KeyheaderstringYesUnique key for this operation; reuse the original value when retrying
idpathstringYesUnique endpoint identifier
urlbodystringNoNew receiver URL; cannot be cleared; same requirements as creation
enabledbodybooleanNoWhether delivery is enabled; false disables delivery

Request example​

PATCH /v1/webhook-endpoints/we_example
Authorization: Bearer inv_test_...
Content-Type: application/json
Idempotency-Key: 65ded8e0-a034-49cb-8d7c-4b279a7382fd
{
"enabled": false
}

Response example​

200 OK, with the updated Webhook Endpoint object, without secret.

{
"id": "we_example",
"url": "https://merchant.example.com/webhooks/invisi",
"enabled": false,
"created_at": "2026-10-15T08:00:00Z",
"updated_at": "2026-10-15T08:10:00Z"
}

Business error codes