Update a Webhook Subscription

Request

Update a webhook subscription by ID.

Security

api_key

Path

idstringrequired

Unique identifier of the webhook to update

x-managed-company-idstring

Optional: the ID of the managed company on behalf of which the request is made

Bodyapplication/jsonrequired

namestring

Name of the webhook. Used for internal identification

Example:"Production Webhook"

urlstring, (uri)

HTTPS URL of the webhook endpoint

Example:"https://example.com/webhook"

eventsArray of strings, non-empty

Event types that trigger the webhook

Items Enum:"job.status.changed""sending.event.file.ready""sending.event.status.changed""peppol.document.received"

Example:

[
  "job.status.changed",
  "sending.event.status.changed",
  "peppol.document.received"
]

statusstring

Webhook status (active/disabled)

Enum:"ACTIVE""DISABLED"

Example:"DISABLED"

curl -i -X PATCH \
  'https://doc.acc.connect.easypost.eu/_mock/public-api/openapi/webhooks/{id}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -H 'x-managed-company-id: string' \
  -d '{
    "name": "Production Webhook",
    "url": "https://example.com/webhook",
    "events": [
      "job.status.changed",
      "sending.event.status.changed",
      "peppol.document.received"
    ],
    "status": "DISABLED"
  }'

Responses

Bodyapplication/json

idstringrequired

Unique identifier of the webhook

Example:"01HQXYZ123ABC456DEF789GHI"

namestringrequired

Name of the webhook. Used for internal identification

Example:"Production Webhook"

urlstringrequired

URL of the webhook endpoint

Example:"https://example.com/webhook"

eventsArray of stringsrequired

Event types that trigger the webhook

Items Enum:"job.status.changed""sending.event.file.ready""sending.event.status.changed""peppol.document.received"

Example:

[
  "job.status.changed",
  "sending.event.status.changed"
]

createdAtstringrequired

Creation timestamp of the webhook

Example:"2026-06-01T10:30:00.000Z"

statusstringrequired

Status of the webhook

Enum:"ACTIVE""DISABLED"

Example:"ACTIVE"

lastModifiedAtstringrequired

Last modification timestamp of the webhook

Example:"2026-06-04T14:20:00.000Z"

Response

{
  "id": "01HQXYZ123ABC456DEF789GHI",
  "name": "Production Webhook",
  "url": "https://example.com/webhook",
  "events": [
    "job.status.changed",
    "sending.event.status.changed"
  ],
  "createdAt": "2026-06-01T10:30:00.000Z",
  "status": "ACTIVE",
  "lastModifiedAt": "2026-06-04T14:20:00.000Z"
}