---
title: "Send quote"
description: "Emails a quote to the customer through the shop sender, as the Send button does: renders the PDF when needed, attaches it, records the send and returns the quote in full. Recipient, cc, subject and message can be overrid"
url: https://docs.invoicefalcon.com/v3-reference/documents/send-quote/
api: "API v3 reference"
method: POST
path: "/documents/quotes/{id}/send"
---

# Send quote

`POST https://app.invoicefalcon.com/api/v3/external/documents/quotes/{id}/send`

Emails a quote to the customer through the shop sender, as the Send button does: renders the PDF when needed, attaches it, records the send and returns the quote in full. Recipient, cc, subject and message can be overridden for this one email.

**Note:** Sends an email to the customer immediately. Refused when the shop cannot send email (code email_sending_disabled).

## Path parameters

- `id` (string, required)

## Request body

- `to` (string): Recipient email address. Default: the email on the order.
- `cc` (string): Extra recipient copied on the email.
- `subject` (string): Email subject. Default: the subject configured for this document type.
- `message` (string): Email body. Default: the email text configured for this document type.
- `template_id` (integer): Template to render the PDF with. Default: the shop default for this document type.

## Returns

The [document object](https://docs.invoicefalcon.com/v3-reference/documents/).

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

## Examples

### Send to the draft order's email

```sh
curl -X POST "https://app.invoicefalcon.com/api/v3/external/documents/quotes/980191059/send" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Send to another address with your own message

```sh
curl -X POST "https://app.invoicefalcon.com/api/v3/external/documents/quotes/980191059/send" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "buyer@example.com",
    "subject": "Your quote #D12",
    "message": "Here is the quote we discussed.",
    "template_id": 312
  }'
```

## 200

The updated resource.

```json
{
  "id": 980191018,
  "document_type": "quote",
  "invoice_number": "Q-1001",
  "title": "Quote",
  "order": {
    "shopify_order_id": "gid://shopify/DraftOrder/990777",
    "name": "#D1001",
    "number": null
  },
  "customer": {
    "id": null,
    "name": null,
    "email": "quote@example.com",
    "shopify_customer_id": null,
    "phone": null,
    "tax_number": null,
    "eori_number": null,
    "tags": []
  },
  "financial_status": null,
  "currency": "EUR",
  "total": "50.00",
  "issued_on": "2026-11-10",
  "due_on": null,
  "sent_at": null,
  "printed_at": null,
  "reminder_sent_at": null,
  "paid": false,
  "edited": true,
  "trashed": false,
  "e_invoice_status": null,
  "created_at": "2026-11-10T08:35:26Z",
  "shopify_draft_order_id": "gid://shopify/DraftOrder/990777",
  "fulfillment_status": null,
  "dates": {
    "order_placed_at": null,
    "issued_on": "2026-11-10",
    "due_on": null,
    "tax_date": null,
    "fulfilled_on": null
  },
  "po_number": null,
  "payment_terms": null,
  "payment_gateway": null,
  "locale": null,
  "totals": {
    "currency": "EUR",
    "taxes_included": null,
    "subtotal": "0.00",
    "discounts": "0.00",
    "shipping": "0.00",
    "tax": "0.00",
    "duties": "0.00",
    "total": "0.00",
    "total_paid": "0.00",
    "total_refunded": "0.00",
    "total_due": "0.00"
  },
  "billing_address": null,
  "shipping_address": null,
  "line_items": [],
  "shipping_lines": [],
  "tax_lines": [],
  "discount_codes": [],
  "notes": {
    "note": null,
    "custom_note": null,
    "note_attributes": []
  },
  "custom_fields": [],
  "tags": [],
  "tracking": {
    "companies": null,
    "numbers": null
  },
  "pdf": {
    "available": false,
    "filename": null,
    "url": null,
    "generated_at": null
  },
  "e_invoice": {
    "status": null,
    "requested": false,
    "error": null
  },
  "updated_at": "2026-11-10T08:35:26Z",
  "payment_url": "https://shop.example/pay/abc"
}
```

## 401

Missing or unknown `X-Auth-Token`, or the shop uninstalled the app.

```json
{
  "errors": [
    "Invalid API key"
  ],
  "code": "unauthorized"
}
```

## 403

`v3_required`: the shop still runs the previous dashboard. `paid_plan_required`: API access needs a paid plan.

```json
{
  "errors": [
    "API access requires a paid plan"
  ],
  "code": "paid_plan_required"
}
```

## 404

The resource does not exist for this shop, or no action is registered at this path.

```json
{
  "errors": [
    "Resource not found"
  ],
  "code": "not_found"
}
```

## 422

The request failed validation. Nothing was saved.

```json
{
  "errors": [
    "id is missing"
  ]
}
```

## 429

Rate limited: cost-weighted per key (reads cost less than writes). Wait `Retry-After` seconds; see `X-RateLimit-*` headers.

```json
{
  "errors": [
    "Rate limit exceeded"
  ],
  "code": "rate_limited"
}
```

