Update webhook

Partially update a webhook. Only the fields included in the request body are changed; omitted fields retain their current values. Pass "description": null to clear the description.

Update webhook

patch

Partially update a webhook. Only the fields included in the request body are changed; omitted fields retain their current values. Pass "description": null to clear the description.

Authorizations

AuthorizationstringRequired

API Token authentication

Path parameters

webhookIdstringRequired

Webhook ID (returned when the webhook was created)

Example: 019683f8-1234-7abc-8def-0123456789ab

Body

Fields to update. All fields are optional; only provided fields are changed. Pass "description": null to clear the description.

namestring · max: 255Optional

New human-readable name for the webhook

Example: Updated notifier

descriptionstring · nullableOptional

New description, or null to clear it

Example: Now also handles newsletters

statusstring · enumOptional

New status for the webhook

Example: pausedPossible values:

urlstring · max: 2048Optional

New URL to deliver events to

Example: https://example.com/webhooks/incoming

Responses

200

Success response

application/json

idstringOptional

Unique webhook identifier

Example: 019683f8-1234-7abc-8def-0123456789ab

namestringOptional

Human-readable name for this webhook

Example: New message notifier

descriptionstring · nullableOptional

Optional description of the webhook's purpose

Example: Notifies our CRM when a new email arrives

statusstring · enumOptional

Current status of the webhook

Example: activePossible values:

urlstringOptional

URL that receives webhook POST requests

Example: https://example.com/webhooks/incoming

created_atstring · date-timeOptionalExample: 2026-07-23T12:00:00Z

updated_atstring · date-timeOptionalExample: 2026-07-23T12:00:00Z

400

Error response

application/json

401

Unauthenticated response

application/json

404

Error response

application/json

422

Error response

application/json

500

Error response

application/json

patch/api/mail/v1/webhooks/{webhookId}

PATCH /api/mail/v1/webhooks/{webhookId} HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 166

{
  "name": "Updated notifier",
  "description": "Now also handles newsletters",
  "events": [
    "message.received"
  ],
  "status": "paused",
  "url": "https://example.com/webhooks/incoming"
}

{
  "id": "019683f8-1234-7abc-8def-0123456789ab",
  "mailbox": {
    "id": "AC1a2b3c4d5e6f7g",
    "address": "[e-mail]"
  },
  "name": "New message notifier",
  "description": "Notifies our CRM when a new email arrives",
  "events": [
    "message.received"
  ],
  "status": "active",
  "url": "https://example.com/webhooks/incoming",
  "created_at": "2026-07-23T12:00:00Z",
  "updated_at": "2026-07-23T12:00:00Z"
}