GetbeelDocs

Email the quote PDF to the customer

Marks a draft quote sent. Test keys: the email goes to the team owner only, with a [TEST] subject.

POST
/quotes/{id}/send

Marks a draft quote sent. Test keys: the email goes to the team owner only, with a [TEST] subject.

Authorization

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Path Parameters

id*string

Header Parameters

Idempotency-Key?string

Recommended. Retrying with the same key and body within 24 hours replays the first response (header Idempotent-Replayed: true) instead of acting twice. The same key with a different body returns 422 idempotency_key_reused.

Lengthlength <= 255
Getbeel-Company?string

Act on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.

Formatuuid

Request Body

application/json
  1. body
to?array<>

Recipient email addresses, up to 10; default: the customer's email on the quote

Items1 <= items <= 10
cc?array<>

Email addresses copied on the email, up to 10. Ignored with a test key (the email goes only to the team owner).

Itemsitems <= 10
language*string
Default"it"
Value in"it""en"
message?string

A personal note added to the email body, up to 2000 characters

Lengthlength <= 2000

Response Body

OK

application/json
  1. response
quote*
sent_to*array<string>

Where it went: the recipients for live quotes; the team owner only for sandbox quotes

Example Request
curl -X POST 'https://www.getbeel.com/api/v1/quotes/string/send' \  -H 'Content-Type: application/json' \  -d '{  "language": "it"}'
Example Response
{  "quote": {    "object": "quote",    "id": "qt_5b0e…",    "livemode": true,    "number": "12/2026",    "status": "draft",    "date": "2026-10-29",    "valid_until": "2026-10-29",    "customer": {      "name": "string",      "email": "string",      "partita_iva": "string",      "codice_fiscale": "string",      "country": "string",      "address": "string",      "postal_code": "string",      "city": "string",      "province": "string",      "codice_destinatario": "string",      "pec": "string"    },    "lines": [      {        "description": "string",        "quantity": 0,        "unit_price": 0,        "unit": "string",        "vat_rate": 0,        "natura": "string",        "amount": "122.00"      }    ],    "notes": "string",    "currency": "string",    "amount_subtotal": "122.00",    "amount_tax": "122.00",    "amount_total": "122.00",    "invoice_id": "string",    "sent_at": "2019-08-24T14:15:22Z",    "accepted_at": "2019-08-24T14:15:22Z",    "declined_at": "2019-08-24T14:15:22Z",    "converted_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z"  },  "sent_to": [    "string"  ]}