---
title: "Create Recipient Map"
method: POST
path: "/api/v1/add/recipient_map"
tags: ["Address Rewriting"]
---

# Create Recipient Map

`POST /api/v1/add/recipient_map`

Using this endpoint you can create a recipient map to forward all mails from one email address to another.

## Request body

- object
  - `active` number — 1 for a active user account 0 for a disabled user account
  - `recipient_map_new` string — the email address that should receive the forwarded emails
  - `recipient_map_old` string — the email address which emails should be forwarded

## Response `200`

OK

- object
  - `log` unknown[] — contains request object
    - unknown
  - `msg` unknown[]
    - unknown
  - `type` 'success' | 'danger' | 'error'

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/mailcow/apis/mailcow-api.md) · [All operations](https://skmtc.dev/mailcow/apis/mailcow-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mailcow/mailcow-api/revisions/ae01d1d7886a/schema)