# Each company chooses its sender and default email content

New `GET`/`PUT /v1/companies/{company_id}/email-configuration`: the address a company's invoice emails use, plus default subject, message, cc and extra recipients.

Oct 23, 2026 · New

A company inherits the account's default sending domain, can pick another one, or can stay on BeeL.'s address. The response includes `sender.effective`, the address the next invoice email will actually use, and a `reason` when it is not your domain. The same call sets the default subject, message, `cc` and `additional_recipients` of the company's invoice emails. `GET /v1/email-template-variables` lists the placeholders those texts accept, such as `{invoiceNumber}`. Templates saved with the older Spanish placeholders now read back with the English names; the Spanish ones are still filled in.

## Endpoints

- `GET /v1/companies/{company_id}/email-configuration` — Sender chosen, address in effect and defaults
- `PUT /v1/companies/{company_id}/email-configuration` — Replace the sender, and optionally the defaults
- `GET /v1/email-template-variables` — Placeholders for subject and message

## Where to go next

- [Which address an email actually uses](/guides/custom-sending-domain#effective-sender)
- [Template variables](/emails/listEmailTemplateVariables)

---

Full OpenAPI spec: https://docs.beel.es/api/openapi