---
title: "Forward an inbox's received mail to another address"
method: PUT
path: "/inboxes/{id}/forwarding"
tags: ["Inbound email"]
---

# Forward an inbox's received mail to another address

`PUT /inboxes/{id}/forwarding`

## Request

- Base URL: `https://sendhq.cc/api/v1`
- URL: `https://sendhq.cc/api/v1/inboxes/{id}/forwarding`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sendhq/apis/sendhq-api/docs/inboxes/:id/forwarding/put.ts> (a function with typed inputs; its response is checked against the schema)

Set `forward_to` to an email address, or null to turn forwarding off. The account owner's own address activates immediately; any other address receives a confirmation email (sent from the inbox's verified domain and metered as one recipient) and forwarding stays pending until the link is confirmed. Forwarded copies are sent from the inbox address with the original sender as Reply-To, respect suppressions and plan limits, and are never re-forwarded.

## Path parameters

- `id` string, required

## Request body

- object
  - `forward_to` string, email, required

## Response `200`

Successful response

- object
  - `id` string, required
  - `address` string, email, required
  - `forwardTo` string, email, required
  - `forwardStatus` string, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `402`: A paid entitlement is required for this recipient or feature
- `403`: The workspace, domain, policy, or suppression state forbids the operation
- `404`: Tenant-scoped resource not found
- `409`: Resource state or idempotency conflict
- `413`: Attachment count or bytes exceed the accepted limit
- `422`: Request validation or suppression check failed
- `423`: Sending is paused for this sender identity or workspace; the message gives the reason and how to appeal
- `429`: A monthly, daily, or trial usage limit was reached
- `500`: Unexpected server error
- `502`: An upstream provider operation failed
- `503`: A required provider or signing configuration is unavailable
- `default`: An error response using SendHQ's standard JSON envelope

---

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