---
title: "Update sending settings"
description: "Update who sends the shop's customer notifications: email and SMS provider, sender name, the merchant's own sending address, store domain in SMS links, Klaviyo marketing consent and the Postscript API key (write only). T"
url: https://docs.stoqapp.com/v2-reference/account-sending/update-sending-settings/
api: "API v2 reference"
method: PATCH
path: "/account/sending"
---

# Update sending settings

`PATCH https://app.stoqapp.com/api/v2/external/account/sending`

Update who sends the shop's customer notifications: email and SMS provider, sender name, the merchant's own sending address, store domain in SMS links, Klaviyo marketing consent and the Postscript API key (write only). The email font, text sizes and logo size are [`PATCH /account/templates/email_style`](https://docs.stoqapp.com/v2-reference/account-templates/update-the-email-style/).

**Note:** Deep partial: absent fields are unchanged. Applies to back-in-stock and preorder notifications. use_custom_email_address true needs sender_address on a domain that is not a free mail provider, and DKIM set up for it ([`POST /account/sending/verify_domain`](https://docs.stoqapp.com/v2-reference/account-sending/verify-the-sending-domain/)) before mail goes out from it. postscript_api_key is never returned by any read; it is checked with Postscript before anything is saved, and nothing is saved when Postscript refuses it; &quot;&quot; removes it. email_reply_to_address is still accepted as a deprecated name for sender_address.

## Headers

- `Idempotency-Key` (string): A fresh unique key for every write (a new UUID, say); reuse it only to retry that write. Keys are remembered for 1 hour: the same key and the same request within that hour returns the first result, with `Idempotent-Replayed: true`, without running again; the same key with a different method, path or body is refused (422 `idempotency_key_reused`); a retry while the first is still running gets 409 `idempotency_key_in_progress`. Keys are per store. Server errors and rate limits are not kept, so their retry runs.

## Request body

- `email_provider` (string): &quot;stoq&quot; (STOQ sends), &quot;klaviyo&quot; (Klaviyo flows send) or &quot;flow&quot; (Shopify Flow sends). One of: `stoq`, `klaviyo`, `flow`.
- `sms_provider` (string): &quot;stoq&quot; (STOQ sends), &quot;klaviyo&quot; or &quot;postscript&quot; (the merchant's account sends). One of: `stoq`, `klaviyo`, `postscript`.
- `email_from_name` (string): Sender name customers see on emails.
- `use_custom_email_address` (boolean): True sends from the merchant's own address (sender_address), which needs DKIM set up for its domain; false sends from STOQ's default address and clears sender_address. Either way customer replies go to the merchant (reply_to_address on the read), never to STOQ.
- `sender_address` (string): The merchant's own address to send from, used while use_custom_email_address is on. The read returns null on STOQ's default address. Not a free mail domain (gmail.com and the like). email_reply_to_address is a deprecated name for it.
- `sms_custom_domain_enabled` (boolean): Use the store domain in SMS purchase links.
- `klaviyo_skip_auto_subscribe` (boolean): True stops subscribing signups to Klaviyo marketing; false subscribes them (the editor box ticked).
- `postscript_api_key` (string): Postscript private API key; prefer POST /account/integrations/postscript/connect. Write only: GET /account/integrations/postscript shows connection.connected. Checked with Postscript before it is kept; a key Postscript refuses is not saved. &quot;&quot; removes the key. Refused over Quinn, ChatGPT or Claude (use_key_link).
- `email_reply_to_address` (string): Deprecated name for sender_address.

## Returns

- `email_provider` (string): e.g. `stoq`
- `sms_provider` (string): e.g. `stoq`
- `email_from_name` (string, nullable): e.g. `Stride Supply`
- `use_custom_email_address` (boolean): e.g. `true`
- `sender_address` (string, nullable): e.g. `hello@stridesupply.com`
- `sms_custom_domain_enabled` (boolean): e.g. `false`
- `klaviyo_skip_auto_subscribe` (boolean): e.g. `false`
- `email_from_address` (string, nullable)
- `email_subdomain` (null)
- `email_dkim_verified` (boolean): e.g. `false`
- `sms_allowed` (boolean): e.g. `true`
- `email_allowed` (boolean): e.g. `true`
- `reply_to_address` (string): e.g. `hello@stridesupply.com`
- `sms_restricted_content_verified` (boolean): e.g. `false`
- `custom_address_status` (string): e.g. `pending`
- `sent_from` (object)
  - `name` (string, nullable): e.g. `Stride Supply (STOQ)`
  - `back_in_stock` (string): e.g. `restock@stoqapp.com`
  - `preorders` (string): e.g. `preorders@stoqapp.com`
  - `yahoo_outlook_hotmail_recipients` (string): e.g. `alerts@restockrocket.io`
- `notifications` (object)
  - `back_in_stock` (object)
    - `signup_thank_you` (object)
      - `email` (object)
        - `sender` (string)
        - `fallback_reason` (null)
        - `integration` (null)
        - `enabled` (boolean)
      - `sms` (object)
        - `sender` (string)
        - `fallback_reason` (null)
        - `integration` (null)
        - `enabled` (boolean)
    - `restock_alert` (object)
      - `email` (object)
        - `sender` (string): e.g. `stoq`
        - `fallback_reason` (null)
        - `integration` (null)
        - `enabled` (boolean): e.g. `true`
      - `sms` (object)
        - `sender` (string): e.g. `stoq`
        - `fallback_reason` (null)
        - `integration` (null)
        - `enabled` (boolean): e.g. `true`
    - `reminder` (object)
      - `email` (object)
        - `sender` (string): e.g. `stoq`
        - `fallback_reason` (null)
        - `integration` (null)
        - `enabled` (boolean): e.g. `true`
      - `sms` (object)
        - `sender` (string): e.g. `stoq`
        - `fallback_reason` (null)
        - `integration` (null)
        - `enabled` (boolean): e.g. `true`
  - `preorders` (object)
    - `confirmation` (object)
      - `email` (object)
        - `sender` (string): e.g. `stoq`
        - `fallback_reason` (null)
        - `integration` (null)
        - `enabled` (boolean): e.g. `true`
      - `sms` (object)
        - `sender` (string): e.g. `stoq`
        - `fallback_reason` (null)
        - `integration` (null)
        - `enabled` (boolean): e.g. `true`
    - `shipping_update` (object)
      - `email` (object)
        - `sender` (string): e.g. `stoq`
        - `fallback_reason` (null)
        - `integration` (null)
        - `enabled` (boolean): e.g. `true`
    - `payment_failed` (object)
      - `email` (object)
        - `sender` (string): e.g. `stoq`
        - `fallback_reason` (null)
        - `integration` (null)
        - `enabled` (boolean): e.g. `true`

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

## Example request

```sh
curl -X PATCH "https://app.stoqapp.com/api/v2/external/account/sending" \
  -H "X-Auth-Token: $STOQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email_from_name": "Stride Supply",
    "use_custom_email_address": true,
    "sender_address": "hello@stridesupply.com"
  }'
```

## 202

Success: example response shown.

```json
{
  "email_provider": "stoq",
  "sms_provider": "stoq",
  "email_from_name": "Stride Supply",
  "use_custom_email_address": true,
  "sender_address": "hello@stridesupply.com",
  "sms_custom_domain_enabled": false,
  "klaviyo_skip_auto_subscribe": false,
  "email_from_address": null,
  "email_subdomain": null,
  "email_dkim_verified": false,
  "sms_allowed": true,
  "email_allowed": true,
  "reply_to_address": "hello@stridesupply.com",
  "sms_restricted_content_verified": false,
  "custom_address_status": "pending",
  "sent_from": {
    "name": "Stride Supply (STOQ)",
    "back_in_stock": "restock@stoqapp.com",
    "preorders": "preorders@stoqapp.com",
    "yahoo_outlook_hotmail_recipients": "alerts@restockrocket.io"
  },
  "notifications": {
    "back_in_stock": {
      "restock_alert": {
        "email": {
          "sender": "stoq",
          "fallback_reason": null,
          "integration": null,
          "enabled": true
        },
        "sms": {
          "sender": "stoq",
          "fallback_reason": null,
          "integration": null,
          "enabled": true
        }
      },
      "reminder": {
        "email": {
          "sender": "stoq",
          "fallback_reason": null,
          "integration": null,
          "enabled": true
        },
        "sms": {
          "sender": "stoq",
          "fallback_reason": null,
          "integration": null,
          "enabled": true
        }
      }
    },
    "preorders": {
      "confirmation": {
        "email": {
          "sender": "stoq",
          "fallback_reason": null,
          "integration": null,
          "enabled": true
        },
        "sms": {
          "sender": "stoq",
          "fallback_reason": null,
          "integration": null,
          "enabled": true
        }
      },
      "shipping_update": {
        "email": {
          "sender": "stoq",
          "fallback_reason": null,
          "integration": null,
          "enabled": true
        }
      },
      "payment_failed": {
        "email": {
          "sender": "stoq",
          "fallback_reason": null,
          "integration": null,
          "enabled": true
        }
      }
    }
  }
}
```

## 401

Missing or invalid `X-Auth-Token`.

```json
{
  "errors": [
    "Invalid API key"
  ],
  "code": "auth_invalid",
  "details": [
    {
      "code": "auth_invalid",
      "message": "Invalid API key",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

## 409

An earlier request with the same Idempotency-Key is still running. Wait, then resend the same request with the same key.

```json
{
  "errors": [
    "A request with this Idempotency-Key is still running"
  ],
  "code": "idempotency_key_in_progress",
  "details": [
    {
      "code": "idempotency_key_in_progress",
      "message": "A request with this Idempotency-Key is still running",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

## 422

The request failed validation.

```json
{
  "errors": [
    "name is required"
  ],
  "code": "validation_failed",
  "details": [
    {
      "code": "validation_failed",
      "message": "name is required",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

## 429

Rate limited: cost-weighted per token (read 1, write 2; 360 points / 60s). Check `Retry-After`.

```json
{
  "errors": [
    "Rate limit exceeded"
  ],
  "code": "rate_limited",
  "details": [
    {
      "code": "rate_limited",
      "message": "Rate limit exceeded",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

