Webhooks

Regenerate webhook secret

Regenerate the webhook secret. The previous secret is immediately invalidated. The new secret is returned once.

post/api/v1/mailboxes/{mailboxResourceId}/webhooks/{webhook}/regenerate-secret

Request

  • Base URL: https://api.mail.hostinger.com
  • URL: https://api.mail.hostinger.com/api/v1/mailboxes/{mailboxResourceId}/webhooks/{webhook}/regenerate-secret
  • Auth: HTTP bearer

Path parameters

mailboxResourceIdstring required

Resource ID of the managed mailbox.

webhookstring uuid required

Webhook identifier (UUID v7).

Response

Webhook with new secret.

Example response

{
  "data": {
    "id": "019683f8-1234-7abc-8def-0123456789ab",
    "accountResourceId": "AC1a2b3c4d5e6f7g",
    "mailbox": "user@example.com",
    "name": "New message notifier",
    "description": "Notifies our CRM when a new email arrives",
    "events": [
      "message.received"
    ],
    "status": "active",
    "url": "https://example.com/webhooks/incoming",
    "createdAt": "2026-04-07T12:00:00+00:00",
    "updatedAt": "2026-04-07T12:00:00+00:00",
    "secret": "4a6f8b2d1e9c3f7a0b5d8e2c4f1a7b3d9e6c2f8a1b4d7e0c3f6a9b2d5e8c1f4"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.