Send quote
/documents/quotes/{id}/sendCosts 2 rate-limit points · Rate limits
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.
Sends an email to the customer immediately. Refused when the shop cannot send email (code email_sending_disabled).
Also searched assend quoteemail quoteemail the quote to the customerresend quotesend quote to another addressmail the quote
Path parameters
idstringRequired
Request body
tostringRecipient email address. Default: the email on the order.
ccstringExtra recipient copied on the email.
subjectstringEmail subject. Default: the subject configured for this document type.
messagestringEmail body. Default: the email text configured for this document type.
template_idintegerTemplate to render the PDF with. Default: the shop default for this document type.
Returns
The document object.
Errors
Missing or unknown X-Auth-Token, or the shop uninstalled the app.
v3_required: the shop still runs the previous dashboard. paid_plan_required: API access needs a paid plan.
The resource does not exist for this shop, or no action is registered at this path.
The request failed validation. Nothing was saved.
Rate limited: cost-weighted per key (reads cost less than writes). Wait Retry-After seconds; see X-RateLimit-* headers.
Every error has the same shape: see Errors.
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 '{}'const res = await fetch("https://app.invoicefalcon.com/api/v3/external/documents/quotes/980191059/send", {
method: "POST",
headers: {
"X-Auth-Token": process.env.INVOICE_FALCON_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const data = await res.json();import os
import requests
res = requests.post(
"https://app.invoicefalcon.com/api/v3/external/documents/quotes/980191059/send",
headers={"X-Auth-Token": os.environ["INVOICE_FALCON_API_KEY"]},
json={},
)
data = res.json()require "net/http"
require "json"
uri = URI("https://app.invoicefalcon.com/api/v3/external/documents/quotes/980191059/send")
req = Net::HTTP::Post.new(uri, "X-Auth-Token" => ENV["INVOICE_FALCON_API_KEY"], "Content-Type" => "application/json")
req.body = {}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body)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
}'const res = await fetch("https://app.invoicefalcon.com/api/v3/external/documents/quotes/980191059/send", {
method: "POST",
headers: {
"X-Auth-Token": process.env.INVOICE_FALCON_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"to": "buyer@example.com",
"subject": "Your quote #D12",
"message": "Here is the quote we discussed.",
"template_id": 312
}),
});
const data = await res.json();import os
import requests
res = requests.post(
"https://app.invoicefalcon.com/api/v3/external/documents/quotes/980191059/send",
headers={"X-Auth-Token": os.environ["INVOICE_FALCON_API_KEY"]},
json={
"to": "buyer@example.com",
"subject": "Your quote #D12",
"message": "Here is the quote we discussed.",
"template_id": 312
},
)
data = res.json()require "net/http"
require "json"
uri = URI("https://app.invoicefalcon.com/api/v3/external/documents/quotes/980191059/send")
req = Net::HTTP::Post.new(uri, "X-Auth-Token" => ENV["INVOICE_FALCON_API_KEY"], "Content-Type" => "application/json")
req.body = {
to: "buyer@example.com",
subject: "Your quote #D12",
message: "Here is the quote we discussed.",
template_id: 312
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body){
"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"
}{
"errors": [
"Invalid API key"
],
"code": "unauthorized"
}{
"errors": [
"API access requires a paid plan"
],
"code": "paid_plan_required"
}{
"errors": [
"Resource not found"
],
"code": "not_found"
}{
"errors": [
"id is missing"
]
}{
"errors": [
"Rate limit exceeded"
],
"code": "rate_limited"
}