---
title: "Update allowed senders"
method: POST
path: "/allowed_senders/update"
tags: ["ALLOWED SENDERS"]
---

# Update allowed senders

`POST /allowed_senders/update`

Replace the email addresses and domain names on your Allowed or Restricted Senders List using this endpoint. How the email addresses and domain names are used is defined in the current 'mode' value - 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_senders` string[], required — Array of email addresses and domain names.
  - `mode` 'whitelist' | 'blacklist' | 'disabled', required — A string indicating how the list of email address and domain names is interpreted. and should be one of 'whitelist', 'blacklist' or 'disabled'.<br><strong>Warning:</strong> Changing the mode to 'whitelist' or 'blacklist' disables the 'Sender Domains' and 'Single Sender Emails' features.<br>
  - `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 Senders list updated

- object
  - `request_id` string, required
  - `data` object, required
    - `allowed_senders` string[], required — A list of email addresses and domain names
    - `mode` 'whitelist' | 'blacklist' | 'disabled', required — A string indicating how the list of email address and domain names is interpreted.

## 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)