---
title: "Replace webhook custom delivery headers"
method: PUT
path: "/v1/webhooks/{webhook_id}/headers"
tags: ["Webhooks"]
---

# Replace webhook custom delivery headers

`PUT /v1/webhooks/{webhook_id}/headers`

## Request

- Base URL: `https://api.deadsimple.email`
- URL: `https://api.deadsimple.email/v1/webhooks/{webhook_id}/headers`
- Auth: HTTP bearer

Replaces the webhook's custom headers wholesale; send `{"headers": {}}` to clear them. These headers are sent on every delivery attempt and every retry, so an endpoint that requires its own `Authorization` header can be used without polling. Values are write-only — responses mask them.

## Path parameters

- `webhook_id` string, required

## Request body

- object
  - `headers` object, required

## Response `200`

Updated headers (values masked)

---

[API](https://skmtc.dev/deadsimple/apis/dead-simple-email-api.md) · [All operations](https://skmtc.dev/deadsimple/apis/dead-simple-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/deadsimple/apis/dead-simple-email-api/revisions/c697881be131?raw)