---
title: "Update allowed recipients"
method: POST
path: "/allowed_recipients/update"
tags: ["ALLOWED RECIPIENTS"]
---

# Update allowed recipients

`POST /allowed_recipients/update`

Replace the email addresses and domain names on your Allowed Recipients List using this endpoint. Further details of these modes are found in the SMPT2GO Guides. Note that a post to this endpoint will return a success, even if the setting is not in use.

## Request body

- object
  - `allowed_recipients` string[], required — Array of email addresses and domain names.
  - `enabled` boolean, required — A flag indicating if this list should be taken into account when sending
  - `subaccount_id` string — If you wish to make this API call on behalf of a subaccount then include its unique ID here

## Response `200`

Allowed Recipients list updated

- object
  - `request_id` string, required
  - `data` object, required
    - `allowed_recipients` string[], required — A list of email addresses and domain names
    - `enabled` boolean, required — A flag indicating if this list is taken into account when sending

## Other responses

- `400` — 400

---

[API](https://skmtc.net/smtp2go/apis/smtp2go-api-v3-0-4.md) · [All operations](https://skmtc.net/smtp2go/apis/smtp2go-api-v3-0-4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smtp2go/smtp2go-api-v3-0-4/revisions/1ba6b25eebb9/schema)