---
title: "Update sending settings"
description: "Change how the store sends email: the custom \"from\" address, whether copies of every invoice email go to the store and to which addresses, and the customer metafield that adds recipients. Deep partial: only the fields se"
url: https://docs.invoicefalcon.com/v3-reference/account/update-sending-settings/
api: "API v3 reference"
method: PATCH
path: "/account/sending"
---

# Update sending settings

`PATCH https://app.invoicefalcon.com/api/v3/external/account/sending`

Change how the store sends email: the custom &quot;from&quot; address, whether copies of every invoice email go to the store and to which addresses, and the customer metafield that adds recipients. Deep partial: only the fields sent change. Returns the sending section as the read shows it.

**Note:** Applies to every email sent from now on. A new from address is checked against the verified sending domains at once; `from.verified` in the response says whether it is in use. Copies, the metafield and the custom from address need a paid plan.

## Request body

- `from` (object)
  - `email` (string, nullable): The address invoice emails come from. Its domain must be verified (DKIM) before it is used; until then emails go out from the Invoice Falcon address. Null returns to the default sender.
- `copies` (object)
  - `enabled` (boolean): Send a copy of every invoice email to the addresses in `to`.
  - `to` (string, nullable): Addresses for the copies, separated by commas or semicolons.
  - `customer_metafield` (string, nullable): A Shopify customer metafield (namespace.key) holding extra recipients for that customer. Blank to stop using one.

## Returns

- `from` (object)
  - `email` (string): e.g. `billing@acme.example`
  - `verified` (boolean): e.g. `true`
  - `in_use` (boolean): e.g. `true`
- `copies` (object)
  - `enabled` (boolean): e.g. `true`
  - `to` (string): e.g. `a@acme.example, b@acme.example`
  - `customer_metafield` (string)
  - `to_addresses` (array of strings)
- `status` (object)
  - `sending_allowed` (boolean): e.g. `true`
  - `unlimited_sending` (string): e.g. `standard`

Rate limit: this call costs 2 points ([rate limits](https://docs.invoicefalcon.com/v3/docs/api-v3/rate-limits/)).

## Example request

```sh
curl -X PATCH "https://app.invoicefalcon.com/api/v3/external/account/sending" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": {
      "email": "billing@acme.example"
    },
    "copies": {
      "enabled": true,
      "to": "a@acme.example, b@acme.example"
    }
  }'
```

## 200

The updated resource.

```json
{
  "from": {
    "email": "billing@acme.example",
    "verified": true,
    "in_use": true
  },
  "copies": {
    "enabled": true,
    "to": "a@acme.example, b@acme.example",
    "customer_metafield": "",
    "to_addresses": [
      "a@acme.example",
      "b@acme.example"
    ]
  },
  "status": {
    "sending_allowed": true,
    "unlimited_sending": "standard"
  }
}
```

## 401

Missing or unknown `X-Auth-Token`, or the shop uninstalled the app.

```json
{
  "errors": [
    "Invalid API key"
  ],
  "code": "unauthorized"
}
```

## 403

`v3_required`: the shop still runs the previous dashboard. `paid_plan_required`: API access needs a paid plan.

```json
{
  "errors": [
    "API access requires a paid plan"
  ],
  "code": "paid_plan_required"
}
```

## 422

The request failed validation. Nothing was saved.

```json
{
  "errors": [
    "id is missing"
  ]
}
```

## 429

Rate limited: cost-weighted per key (reads cost less than writes). Wait `Retry-After` seconds; see `X-RateLimit-*` headers.

```json
{
  "errors": [
    "Rate limit exceeded"
  ],
  "code": "rate_limited"
}
```

