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

# Get Webhook Headers

`GET /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

List the names of custom HTTP headers included with deliveries to this inbox-scoped webhook.
Header values are write-only and are never returned.

## Path parameters

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

## Response `200`

Response with status 200

- WebhooksWebhookHeaderNamesResponse
  - `header_names` string[], required: Names of the custom delivery headers configured for this webhook. Header values are never returned.

## Other responses

- `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/get.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)