---
title: "Update Webhook Headers"
method: PATCH
path: "/v0/inboxes/{inbox_id}/webhooks/{webhook_id}/headers"
tags: ["inboxes > webhooks"]
---

# Update Webhook Headers

`PATCH /v0/inboxes/{inbox_id}/webhooks/{webhook_id}/headers`

## Request

- Base URL: `https://api.agentmail.to`
- URL: `https://api.agentmail.to/v0/inboxes/{inbox_id}/webhooks/{webhook_id}/headers`
- Auth: HTTP bearer

Atomically set, replace, or remove custom HTTP headers included with deliveries to this
inbox-scoped webhook. Header values remain write-only.

## Path parameters

- `inbox_id` string, required: The ID of the inbox.
- `webhook_id` string, required: ID of webhook.

## Request body

- WebhooksUpdateWebhookHeadersRequest: Set, replace, or remove custom delivery headers. Provide at least one of `headers` or `remove_headers`. A header cannot be set and removed in the same request, regardless of casing.
  - `headers` WebhooksWebhookHeaders: Custom HTTP headers to include with every delivery to this webhook. Header values are write-only: AgentMail never returns them from webhook read endpoints. The map must contain at least one entry when provided, and every name and value must be a valid HTTP header.
  - `remove_headers` string[]: Names of custom delivery headers to remove.

## Response `204`

Response with status 204

- object

## Other responses

- `400`: Error response with status 400
- `404`: Error response with status 404

## Changes

- **2026-10-16** `3f5c7830c952`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentmail-to/apis/api/changes/v0/inboxes/:inbox_id/webhooks/:webhook_id/headers/patch.md)

---

[API](https://skmtc.dev/agentmail-to/apis/api.md) - [All operations](https://skmtc.dev/agentmail-to/apis/api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentmail-to/apis/api/revisions/a9792efe7bdf?raw)