---
title: "Update email settings"
description: "Change the language emails go out in and whether the store's own email text is used instead of the default. Deep partial. To change the text itself use PATCH /account/emails/:kind. Returns the emails section as the read "
url: https://docs.invoicefalcon.com/v3-reference/account/update-email-settings/
api: "API v3 reference"
method: PATCH
path: "/account/emails"
---

# Update email settings

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

Change the language emails go out in and whether the store's own email text is used instead of the default. Deep partial. To change the text itself use [`PATCH /account/emails/:kind`](https://docs.invoicefalcon.com/v3-reference/account/update-one-email-template/). Returns the emails section as the read shows it.

**Note:** Applies to every email sent from now on. Custom email text needs a paid plan.

## Request body

- `locale` (string): Language of the default email texts (and of the subject/body placeholders). One of: `az`, `bg`, `cs`, `da`, `de`, `el`, `en`, `es`, `es-MX`, `et`, `fi`, `fr`, `it`, `ja`, `ko`, `lt`, `lv`, `nl`, `nn`, `pl`, `pt`, `ro`, `sk`, `sl`, `sv`, `zh`.
- `custom_text` (boolean): Use the store's own subject and body (see PATCH /account/emails/:kind) instead of the default text for the language.

## Returns

- `locale` (string): e.g. `de`
- `custom_text` (boolean): e.g. `true`
- `templates` (object)
  - `invoice` (object)
    - `subject` (string): e.g. `{{shop_name}} - Ihre Rechnung zur Bestellung Nr. {{order_…`
    - `body` (string): e.g. `Hallo,

vielen Dank für Ihren Einkauf bei {{shop_name}}. …`
    - `customized` (boolean): e.g. `false`
    - `in_use` (boolean): e.g. `false`
  - `quote` (object)
    - `subject` (string): e.g. `{{shop_name}} - Ihr Angebot {{order_number}}`
    - `body` (string): e.g. `Hallo, danke für die Kontaktaufnahme {{shop_name}}. Wie g…`
    - `customized` (boolean): e.g. `false`
    - `in_use` (boolean): e.g. `false`
  - `credit_note` (object)
    - `subject` (string): e.g. `{{shop_name}} - Gutschrift {{order_number}}`
    - `body` (string): e.g. `Hallo, an dieser E-Mail finden Sie die Gutschrift für Ihr…`
    - `customized` (boolean): e.g. `false`
    - `in_use` (boolean): e.g. `false`
  - `payment_reminder` (object)
    - `subject` (string): e.g. `{{shop_name}} - Erinnerung an Ihre Rechnung Nr. {{order_n…`
    - `body` (string): e.g. `Hallo,
danke für den Einkauf bei {{shop_name}}. Dies ist …`
    - `customized` (boolean): e.g. `false`
    - `in_use` (boolean): e.g. `false`

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/emails" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "locale": "de",
    "custom_text": true
  }'
```

## 200

The updated resource.

```json
{
  "locale": "de",
  "custom_text": true,
  "templates": {
    "invoice": {
      "subject": "{{shop_name}} - Ihre Rechnung zur Bestellung Nr. {{order_number}}",
      "body": "Hallo,\n\nvielen Dank für Ihren Einkauf bei {{shop_name}}. Im Anhang finden Sie die Rechnung für Ihre Bestellung {{order_number}}.\n\nMit freundlichen Grüßen\n\ndas Team von {{shop_name}}",
      "customized": false,
      "in_use": false
    },
    "quote": {
      "subject": "{{shop_name}} - Ihr Angebot {{order_number}}",
      "body": "Hallo, danke für die Kontaktaufnahme {{shop_name}}. Wie gewünscht habe ich Ihr Angebot an diese E-Mail angehängt. Bitte werfen Sie einen Blick darauf und teilen Sie mir mit, wie Sie fortfahren möchten.\n\nMit freundlichen Grüßen\n\ndas Team von {{shop_name}}",
      "customized": false,
      "in_use": false
    },
    "credit_note": {
      "subject": "{{shop_name}} - Gutschrift {{order_number}}",
      "body": "Hallo, an dieser E-Mail finden Sie die Gutschrift für Ihre Bestellung.\n\nMit freundlichen Grüßen\n\ndas Team von {{shop_name}}",
      "customized": false,
      "in_use": false
    },
    "payment_reminder": {
      "subject": "{{shop_name}} - Erinnerung an Ihre Rechnung Nr. {{order_number}}",
      "body": "Hallo,\ndanke für den Einkauf bei {{shop_name}}. Dies ist eine sanfte Erinnerung daran, dass Ihre Rechnung überfällig ist.\n\nWenn Sie diese Rechnung bereits bezahlt haben, ignorieren Sie diese Nachricht bitte.\n\nBeste,\nDas {{shop_name}}-Team",
      "customized": false,
      "in_use": false
    }
  }
}
```

## 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"
}
```

