---
title: "Set invoice email"
method: PATCH
path: "/v1/account/invoice-email"
tags: ["account"]
---

# Set invoice email

`PATCH /v1/account/invoice-email`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/account/invoice-email`
- Auth: HTTP bearer

Sets one more email address that receives every invoice Brix issues to a workspace billed directly by Brix. The workspace owners always receive invoices too. Send `null` or an empty string to remove it. Returns 422 if the value is not one email address, and 409 if the workspace is billed through the billing provider.

## Request body

- object
  - `email` string, nullable, required: One more address for every invoice. `null` or empty removes it.

## Response `200`

Success.

- object
  - `data` object, required
    - `payment` AccountPayment, required: Payment settings of an account that Brix invoices directly.
      - `option` 'card' | 'invoice', required: How issued invoices are paid: charged to the saved card, or paid from the invoice email.
      - `card` object, nullable, required
        - `brand` string, required
        - `last4` string, nullable, required
        - `expMonth` integer, nullable, required
        - `expYear` integer, nullable, required
        - `savedAt` string, nullable, required: ISO-8601 timestamp (UTC).
      - `backupCard` object, nullable, required: Charged once when the card is declined.
        - `brand` string, required
        - `last4` string, nullable, required
        - `expMonth` integer, nullable, required
        - `expYear` integer, nullable, required
        - `savedAt` string, nullable, required: ISO-8601 timestamp (UTC).
      - `lastPaid` object, nullable, required: The card the last invoice was paid with.
        - `label` string, required: `Visa •••• 5278`.
        - `brand` string, required
        - `last4` string, required
        - `invoiceNumber` string, required
        - `paidAt` string, nullable, required: ISO-8601 timestamp (UTC).
      - `cardAvailable` boolean, required: Card payment can be set up for this workspace.
      - `invoiceEmail` string, nullable, required: One more address that gets every invoice. The owners always get them.

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: You do not hold the permission for the whole workspace (a grant at one location is not enough).
- `404`: A workspace billed by a partner.
- `409`: `not_brix_billed`.
- `422`: Not one email address.
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

[API](https://skmtc.dev/brixsignage/apis/brix-api.md) · [All operations](https://skmtc.dev/brixsignage/apis/brix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brixsignage/apis/brix-api/revisions/02fd3665dc7d?raw)