# manage_forwarders

> List, create or delete email forwarders on a domain — an address that redirects mail to one or more destinations.

- Tier: W
- Required scope: read:email
- Annotations: none
- Docs: https://api.inleed.com/tools/manage-forwarders

## Description

List, create or delete email forwarders on a domain — an address that redirects mail to one or more destinations. This — not MX or DNS records — is the answer to "what forwarding exists on my domain". `action=list` returns each forwarder and its destinations and needs only read access; `action=create` needs `address` and `destinations[]`; `action=delete` needs `address`; both writes need the `write:email` scope. For `list`, a domain input covers that domain and a service id covers every domain on the account (`scope` says which); writes land on the domain in `address`.

## Input schema

- `input` — string (required). The domain or account that owns the forwarders — a domain, email, URL or Inleed service id. Resolved to the owning account; the resolved target is echoed back.
- `action` — enum (required). list all forwarders, create a new one, or delete one. create and delete require the write:email scope. One of list, create, delete.
- `address` — string. The forwarder source address (e.g. info@example.com or just info).
- `destinations` — string[]. For create: the destination email addresses mail should be forwarded to. One or more.

## Example call

```json
{
  "name": "manage_forwarders",
  "arguments": {
    "input": "example.se",
    "action": "list",
    "address": "info@example.se"
  }
}
```