Update Webhook

PATCHhttps://api.inboxjot.com/v1/webhooks/{endpoint_id}

Updates the fields you send and keeps the others. Send status: "enabled" to turn a webhook back on. Needs a Full key. A key limited to one domain answers 403. Send an optional Idempotency-Key header to retry safely. See Idempotency.

PATCH/v1/webhooks/{endpoint_id}

curl -X PATCH https://api.inboxjot.com/v1/webhooks/whk_06d2mfk8r8ja5fv2xn7qe \
  -H "Authorization: Bearer $INBOXJOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "disabled"
  }'

{
  "id": "whk_06d2mfk8r8ja5fv2xn7qe",
  "name": "Production",
  "url": "https://api.acme.dev/webhooks/inboxjot",
  "events": [
    "email.delivered",
    "email.bounced",
    "email.complained"
  ],
  "status": "disabled",
  "disabled_reason": null,
  "created_at": "2026-10-21T09:00:00.000Z",
  "updated_at": "2026-10-21T09:00:00.000Z"
}

Returns the updated webhook.

Path Parameters

endpoint_idstringrequired

The webhook id.

Body Parameters

namestring | null

The webhook name, 1 to 100 characters.

urlstring | null

An https:// URL on a public address, up to 2,000 characters. It cannot hold a user name or password.

eventsstring[] | null

At least one event type. It replaces the old list.

statusstring | null

enabled or disabled.

Response

idstring

The webhook id.

namestring

The webhook name.

urlstring

Where events are sent.

eventsstring[]

The event types it gets.

statusstring

enabled or disabled. Inboxjot turns a webhook off when deliveries keep failing.

disabled_reasonstring | null

Why the webhook was turned off.

created_atstring

When it was created.

updated_atstring

When it last changed.

Responses

curl -X PATCH https://api.inboxjot.com/v1/webhooks/whk_06d2mfk8r8ja5fv2xn7qe \ -H "Authorization: Bearer $INBOXJOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "status": "disabled" }'

{ "id": "whk_06d2mfk8r8ja5fv2xn7qe", "name": "Production", "url": "https://api.acme.dev/webhooks/inboxjot", "events": [ "email.delivered", "email.bounced", "email.complained" ], "status": "disabled", "disabled_reason": null, "created_at": "2026-10-21T09:00:00.000Z", "updated_at": "2026-10-21T09:00:00.000Z" }