---
title: "Email a fiscal document"
method: POST
path: "/fiscal-document/v1/fiscal-documents/{id}/email"
tags: ["Fiscal Documents"]
---

# Email a fiscal document

`POST /fiscal-document/v1/fiscal-documents/{id}/email`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/fiscal-document/v1/fiscal-documents/{id}/email`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://api.cloudbeds.com/auth/oauth/authorize`
    - Token URL: `https://api.cloudbeds.com/auth/oauth/token` scopes: `write:reservation`

Initiates the process to send the invoice to a customer

## Path parameters

- `id` string, required

## Headers

- `X-Property-ID` integer, required

## Request body

- FiscalDocumentEmailRequest
  - `emails` string[], required
  - `fileIds` string[]: Ids of additional stored files to attach (from files on the list response), e.g. the Portuguese duplicate. The primary file is always attached; these are added on top. Absent or empty attaches only the primary file. Duplicate ids are ignored.
  - `subject` string, nullable: Optional per-send override for the email subject. When omitted or blank, the subject is resolved from the property's email template, falling back to the service default. Supports the same [Placeholder] tokens as template subjects.

## Response `200`

OK

- object

---

[API](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api.md) - [All operations](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api/revisions/9c2a47775e5e?raw)
