---
title: "Set or clear the domain catch-all address"
method: PUT
path: "/api/domains/{id}/catchall"
tags: ["Aliases"]
---

# Set or clear the domain catch-all address

`PUT /api/domains/{id}/catchall`

## Request

- Base URL: `https://arc-relay.com`
- URL: `https://arc-relay.com/api/domains/{id}/catchall`
- Auth: HTTP bearer

Sets where mail to addresses without an alias is delivered. An empty, missing, or null catchall_forward_to clears it (that mail then goes to the account email). Domain must be verified.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `catchall_forward_to` string, nullable

## Response `200`

Updated catchall_forward_to (null when cleared)

## Other responses

- `400`: Invalid or private/internal forwarding address
- `403`: Domain not verified
- `404`: Domain not found

---

[API](https://skmtc.dev/arc-relay/apis/arc-relay-api.md) · [All operations](https://skmtc.dev/arc-relay/apis/arc-relay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/arc-relay/apis/arc-relay-api/revisions/1743ed2c49bc?raw)