# Send document by email Sends the specified estimate by email to the client. Endpoint: POST /api/v3/{estimate_type}/{id}/send Version: 3.1.0 Security: apiKeyAuth ## Path parameters: - `estimate_type` (string, required) Type of estimate document (quotes, proformas, fees_notes). Enum: "quotes", "proformas", "fees_notes" - `id` (integer, required) The document ID. Example: 541674 ## Query parameters: - `api_key` (string, required) Your API Key. Example: "YOUR_API_KEY" ## Request fields (application/json): - `send` (object) - `send.to` (string) Recipient(s). When blank, falls back to the document's client email, then to the account email (trial accounts always fall back to the user's own email). Example: "client@example.com" - `send.email_cc` (string) Cc recipient(s). - `send.email_bcc` (string) Bcc recipient(s). - `send.subject` (string) Example: "Your document is ready" - `send.body` (string) Example: "Hello,\n\nPlease find your document attached.\n\nRegards,\ninvoicexpress\n" - `send.send_copy` (boolean) Also send a copy to the requesting user's email (added to to). - `send.update_preferred_contact` (boolean) Save the to addresses as the client's preferred contact email. - `send.document_url` (string) Link used for the "view online" button; defaults to the document permalink in the client's language. Example: "https://web.invoicexpress.com/documents/541674bbfcdd182143fe2747524df08ab1367ef8255010?language=en" ## Response 200 fields (application/json): - `email_to` (string) Comma-separated recipients, including the user's own email when send_copy was true. Example: "client@example.com" - `email_cc` (string) Example: "cc1@example.com,cc2@example.com" - `email_bcc` (string) Example: "finance@example.com" ## Response 401 fields (application/json): - `errors` (array) Example: [{"error":"Authentication Error"}] - `errors.error` (string) ## Response 403 fields (application/json): - `errors` (array) Example: [{"error":"Email service is disabled for your account. To activate it, please contact us at support@invoicexpress.com."}] - `errors.error` (string) ## Response 404 fields (application/json): - `errors` (array) Example: [{"error":"Resource not found"}] - `errors.error` (string) ## Response 422 fields (application/json): - `errors` (array) Example: [{"error":"client@example is an invalid email"}] - `errors.error` (string) ## Response 500 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string)