Email Invoice PDF API
Send invoice PDF documents to specified email addresses for record-keeping and accounting purposes
Email Invoice PDF API
Distribute invoice PDFs electronically to customers or accounting departments. Send professional invoices to multiple email addresses with a single API call.
Email Delivery
Send invoices directly to customer email addresses.
PDF Format
Professional PDF invoices with all transaction details.
Multiple Recipients
Send to multiple email addresses simultaneously.
Endpoint Overview
/graphqlSend an invoice PDF to one or more email addresses. The invoice is generated as a PDF and delivered to all specified recipients.
Request Parameters
invoiceIdInt!RequiredThe unique identifier of the invoice to send.
emailsToSend[String!]!RequiredArray of email addresses to send the invoice PDF to.
GraphQL Mutation
mutation emailInvoicePDF($invoicePdf: InvoicePDF) {
emailInvoicePDF(invoicePdf: $invoicePdf)
}Variables (Single Recipient):
{
"invoicePdf": {
"invoiceId": 12345,
"emailsToSend": ["billing@company.com"]
}
}Variables (Multiple Recipients):
{
"invoicePdf": {
"invoiceId": 12345,
"emailsToSend": [
"billing@company.com",
"accounting@company.com",
"john.doe@company.com"
]
}
}HTTP Request:
curl -X POST https://api.orbnet.com/graphql \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-d '{
"query": "mutation emailInvoicePDF($invoicePdf: InvoicePDF) { emailInvoicePDF(invoicePdf: $invoicePdf) }",
"variables": {
"invoicePdf": {
"invoiceId": 12345,
"emailsToSend": ["billing@company.com", "accounting@company.com"]
}
}
}'Response
{
"data": {
"emailInvoicePDF": true
}
}{
"errors": [
{
"message": "Invoice not found",
"path": ["emailInvoicePDF"],
"extensions": {
"code": "INVOICE_NOT_FOUND"
}
}
],
"data": null
}{
"errors": [
{
"message": "Invalid email address format",
"path": ["emailInvoicePDF"],
"extensions": {
"code": "INVALID_EMAIL",
"invalidEmail": "not-an-email"
}
}
],
"data": null
}Common Use Cases
Customer Receipt
Send invoice to customer after successful payment for their records.
Business Accounting
Send to accounting department for expense tracking and reporting.
Multiple Stakeholders
Send to both customer and internal finance team simultaneously.
Resend Invoices
Resend invoices when original email was missed or lost.
Invoice PDF Contents
Transaction Details
Invoice number, date, payment method, and transaction ID.
Amount Breakdown
Subscription cost, add-ons, taxes, and total amount.
Customer Information
Name, email, company name, and address if provided.
Tax Information
Tax ID, VAT number, and applicable tax amounts.
Best Practices
Validate Emails
Verify email format before calling the API to avoid errors.
Update First
Use updateInvoice to add company/tax details before sending.
Confirm Delivery
A true response means emails were queued. Check spam folders if not received.
Rate Limiting
Avoid sending the same invoice repeatedly in short periods.
Related Endpoints
Professional Invoices
For professional invoices, use the Update Invoice API to add company name, address, and tax ID before sending the PDF. This ensures the invoice meets business accounting requirements.
Complete Invoice Details First
Before sending invoices, ensure all company and tax information is updated for professional, compliant documentation.