Skip to main content
POST
/
api
/
v1
/
invoices
/
{number}
/
send-email
curl -X POST https://api.yourapp.com/api/v1/invoices/FACT-12345/send-email \
  -H "Authorization: Bearer <local_jwt>" \
  -H "X-Factus-Token: <factus_access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]"
  }'

{
  "message": "Correo enviado exitosamente",
  "data": {
    "status": "success",
    "message": "Email sent successfully to [email protected]"
  }
}

​
Headers

​
Authorization
string
required
Bearer token for authentication: Bearer <local_jwt>
​
X-Factus-Token
string
required
Factus access token obtained from authentication

​
Path Parameters

​
number
string
required
The invoice number to send via email

​
Request Body

​
email
string
required
Recipient email address
​
pdf_base_64_encoded
string
Optional Base64-encoded PDF file to attach to the email. If not provided, the system will generate the PDF automatically.

​
Response

​
message
string
Success message
​
data
object
Email send response
curl -X POST https://api.yourapp.com/api/v1/invoices/FACT-12345/send-email \
  -H "Authorization: Bearer <local_jwt>" \
  -H "X-Factus-Token: <factus_access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]"
  }'

{
  "message": "Correo enviado exitosamente",
  "data": {
    "status": "success",
    "message": "Email sent successfully to [email protected]"
  }
}

​
Usage Notes

  • If pdf_base_64_encoded is not provided, the system will automatically generate and attach the invoice PDF
  • The email will include the invoice details and the PDF attachment
  • Make sure the email address is valid and properly formatted
  • The PDF attachment (if provided) must be a valid Base64-encoded PDF file

Build docs developers (and LLMs) love

Get started for freeTalk to us