Send Invoice
Issues a draft and emails it to its recipients, with reminders after the due date. A draft with a payment_method_id is charged instead of emailed, which requires payment:charge, and its recipients get the payment link if the charge fails. Sending an open invoice emails it again, up to three emails a day including the first send. With send_at, the draft is sent at that time instead, and cannot be edited, except its recipients, until it is sent or unscheduled. Each email, reminders included, is sent separately to the customer email shown on the invoice and to each address in recipient_emails, so recipients never see each other’s addresses.
Authorizations
An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Headers
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
Pins the request to a dated API version.
"2026-10-24"
Path Parameters
The invoice's pay_ ID.
Body
When to send the draft, as an ISO 8601 timestamp in the future. Omit to send now.
Response
invoice sent
"biz_xxxxxxxxxxxxxx"
0
A signed link that opens this invoice in a checkout session so the buyer can pay it: pass it as link to POST /checkout_sessions. Present once the invoice is issued and open; null while it is a draft, once it is paid or void, for an invoice with no product, and when you lack payment:charge.
"pay_xxxxxxxxxxxxxx.eyJfcmFpbHMiOnsiZGF0YSI6WzEsZmFsc2VdLCJwdXIiOiJSZWNlaXB0XG5jaGVja291dF9tb3VudFxuIn19--xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
"2026-01-01T12:00:00.000Z"
"Dana"
null
"marcus@shinetime.example"
"pay_xxxxxxxxxxxxxx"
null
null
"mber_xxxxxxxxxxxxxx"
"#xxxxxxxx"
invoice "invoice"
false
null
null
Invoice email recipients, independent of the billed customer.
null
draft, open, authorized, paid, pending, uncollectible, unresolved, void "open"
estimated, final "final"
"2026-01-01T12:00:00.000Z"

