---
title: "Update a platform webhook"
method: PATCH
path: "/platform/webhooks/{webhookId}"
tags: ["Platform Webhooks"]
---

# Update a platform webhook

`PATCH /platform/webhooks/{webhookId}`

Update a platform webhook's configuration.

You can update:
- `name` - Display name for the webhook
- `url` - The endpoint URL (must be HTTPS)
- `events` - Array of event types to receive (empty array = all events)
- `enabled` - Enable or disable the webhook

## Request body

- UpdatePlatformWebhookRequest
  - `name` string — Display name for the webhook
  - `url` string, uri — Webhook endpoint URL (must be HTTPS)
  - `events` string[] — Events to subscribe to. Empty array means all events.
  - `enabled` boolean — Enable or disable the webhook

## Response `200`

Platform webhook updated

- PlatformWebhookResponse
  - `success` true, required
  - `data` object, required
    - `id` string, required — Platform webhook ID
    - `name` string, required — Webhook name for identification
    - `url` string, uri, required — Webhook endpoint URL
    - `events` string[], required — Subscribed events (empty = all events)
    - `enabled` boolean, required — Whether the webhook is active
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `meta` ApiMeta, required
    - `requestId` string, required — Unique request identifier for debugging and support

## Other responses

- `400` — Invalid request parameters
- `401` — Invalid or missing API key
- `404` — Resource not found
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/arkhq-io/apis/ark-email-api.md) · [All operations](https://skmtc.net/arkhq-io/apis/ark-email-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arkhq-io/ark-email-api/revisions/98a90852ffca/schema)