Update Webhook Endpoint

PATCH

/api/:account_id/webhook-endpoints/:external_id

PATCH

/api/:account_id/webhook-endpoints/:external_id

$ curl -X PATCH https://app.paymentkit.com/api/account_id/webhook-endpoints/external_id \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

1 {
2   "id": "whe_prod_9f8e7d6c5b4a3210",
3   "url": "https://hooks.myapp.com/payment-events",
4   "events": [
5     "payment.succeeded",
6     "payment.failed"
7   ],
8   "is_active": true,
9   "is_protected": false,
10   "is_blacklisted": false,
11   "consecutive_failures": 0,
12   "created_at": "2023-11-20T14:45:00Z",
13   "updated_at": "2024-04-10T11:20:00Z",
14   "description": "Primary production webhook for payment notifications",
15   "blacklisted_at": "2024-01-15T09:30:00Z",
16   "last_failed_delivery": {
17     "last_response_status": 502,
18     "last_error": "Connection refused",
19     "last_attempt_at": "2024-01-15T09:30:00Z"
20   }
21 }

Update a webhook endpoint's settings.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

external_idstringRequired

account_idstringRequired

Request

This endpoint expects an object.

urlstring or nullOptional

Updated URL for the webhook endpoint

descriptionstring or nullOptional<=500 characters

Updated description

eventslist of strings or nullOptional

Updated list of event types

is_activeboolean or nullOptional

Whether the webhook endpoint is active

Response

Successful Response

idstring

Unique webhook endpoint identifier

urlstring

The URL receiving webhook events

eventslist of strings

List of subscribed event types

is_activeboolean

Whether the webhook endpoint is active

is_protectedboolean

Whether the webhook endpoint is protected from deletion

is_blacklistedboolean

Whether the webhook endpoint is blacklisted due to consecutive delivery failures

consecutive_failuresinteger

Number of consecutive delivery failures (resets on success)

created_atdatetime

When the webhook endpoint was created

updated_atdatetime

When the webhook endpoint was last updated

descriptionstring or nullOptional

Webhook endpoint description

blacklisted_atdatetime or nullOptional

When the webhook endpoint was blacklisted (null if not blacklisted)

last_failed_deliveryobject or nullOptional

Information about the last failed delivery (only included for blacklisted endpoints)

Errors

422

Unprocessable Entity Error