---
title: "Update one email template"
description: "Set the store's own subject and/or body for one email kind: invoice, quote, credit_note or payment_reminder. Liquid placeholders are allowed and checked. Sending the default text (or an empty string) returns that field t"
url: https://docs.invoicefalcon.com/v3-reference/account/update-one-email-template/
api: "API v3 reference"
method: PATCH
path: "/account/emails/{kind}"
---

# Update one email template

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

Set the store's own subject and/or body for one email kind: invoice, quote, credit_note or payment_reminder. Liquid placeholders are allowed and checked. Sending the default text (or an empty string) returns that field to the default for the language. The text is only sent when `custom_text` is true ([`PATCH /account/emails`](https://docs.invoicefalcon.com/v3-reference/account/update-email-settings/)); each template says `in_use`. Returns the emails section.

**Note:** Used for every email of that kind from now on, as long as custom text is on (`custom_text` in [`PATCH /account/emails`](https://docs.invoicefalcon.com/v3-reference/account/update-email-settings/)).

## Path parameters

- `kind` (string, required): invoice, quote, credit_note or payment_reminder.

## Request body

- `subject` (string): The email subject; Liquid placeholders such as {{order_number}} are allowed.
- `body` (string): The email body; Liquid placeholders are allowed.

## Returns

- `locale` (string): e.g. `en`
- `custom_text` (boolean): e.g. `false`
- `templates` (object)
  - `invoice` (object)
    - `subject` (string): e.g. `Invoice {{invoice_number}}`
    - `body` (string): e.g. `Thanks!`
    - `customized` (boolean): e.g. `true`
    - `in_use` (boolean): e.g. `false`
  - `quote` (object)
    - `subject` (string): e.g. `{{shop_name}} - Quote for your Order {{order_number}}`
    - `body` (string): e.g. `Hello,

Thank you for shopping at {{shop_name}}. We have …`
    - `customized` (boolean): e.g. `false`
    - `in_use` (boolean): e.g. `false`
  - `credit_note` (object)
    - `subject` (string): e.g. `{{shop_name}} - Credit Note {{order_number}}`
    - `body` (string): e.g. `Hello,

Please find attached the credit note for your ord…`
    - `customized` (boolean): e.g. `false`
    - `in_use` (boolean): e.g. `false`
  - `payment_reminder` (object)
    - `subject` (string): e.g. `{{shop_name}} - Reminder for your Invoice {{order_number}}`
    - `body` (string): e.g. `Hello,

Thank you for shopping at {{shop_name}}. This is …`
    - `customized` (boolean): e.g. `false`
    - `in_use` (boolean): e.g. `false`
- `notice` (string): e.g. `Saved, but not used yet: emails send the default text unt…`

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

## Examples

### Change the invoice email subject

```sh
curl -X PATCH "https://app.invoicefalcon.com/api/v3/external/account/emails/{kind}" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Your invoice {{invoice_number}} from {{shop_name}}"
  }'
```

### Change the subject and body

```sh
curl -X PATCH "https://app.invoicefalcon.com/api/v3/external/account/emails/{kind}" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Invoice for order {{order_number}}",
    "body": "Hi {{customer_name}},\n\nYour invoice for order {{order_number}} is attached."
  }'
```

## 200

The updated resource.

```json
{
  "locale": "en",
  "custom_text": false,
  "templates": {
    "invoice": {
      "subject": "Invoice {{invoice_number}}",
      "body": "Thanks!",
      "customized": true,
      "in_use": false
    },
    "quote": {
      "subject": "{{shop_name}} - Quote for your Order {{order_number}}",
      "body": "Hello,\n\nThank you for shopping at {{shop_name}}. We have attached the Quote for your Order {{order_number}} to this email.\n\nRegards,\nThe {{shop_name}} Team",
      "customized": false,
      "in_use": false
    },
    "credit_note": {
      "subject": "{{shop_name}} - Credit Note {{order_number}}",
      "body": "Hello,\n\nPlease find attached the credit note for your order to this email.\n\nRegards,\nThe {{shop_name}} Team",
      "customized": false,
      "in_use": false
    },
    "payment_reminder": {
      "subject": "{{shop_name}} - Reminder for your Invoice {{order_number}}",
      "body": "Hello,\n\nThank you for shopping at {{shop_name}}. This is a gentle reminder that your invoice {{invoice_number}} is past due.\n\nIf you have already paid this invoice, please disregard this message.\n\nBest,\nThe {{shop_name}} Team",
      "customized": false,
      "in_use": false
    }
  },
  "notice": "Saved, but not used yet: emails send the default text until custom_text is true (PATCH /account/emails {\"custom_text\": true})."
}
```

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

## 404

The resource does not exist for this shop, or no action is registered at this path.

```json
{
  "errors": [
    "Resource not found"
  ],
  "code": "not_found"
}
```

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

