v1

latestOpenAPI 3.0.12026-07-24310590875.6 KB

recurring-invoices

Create a recurring invoice

Create a recurring invoice.

See Recurring invoices in the Guides section for more information, sample requests, and responses.

post/v3/recurring-invoices

Headers

sessionIdstring nullable

API session ID generated with /v3/login

Example:{{session_id}}

devKeystring nullable

Developer key generated with your BILL developer account

Example:{{developer_key}}

Request body

customerIdstring required

BILL-generated ID of the customer. The value begins with 0cu.

paymentTermIdstring

descriptionstring

User-generated invoice number. This value can be your chosen number scheme or invoice due date.

sendEmailboolean

Set as true to send an email to the customer when an invoice is created.

Example request

{
  "customerId": "{{customer_id}}",
  "schedule": {
    "period": "MONTHLY",
    "frequency": 1,
    "nextDueDate": "2026-12-31",
    "endDate": "2027-11-01",
    "daysInAdvance": 5
  },
  "recurringInvoiceLineItems": [
    {
      "amount": 19.99,
      "quantity": 1,
      "description": "Monthly subscription"
    }
  ]
}

Response

Create a recurring invoice response

idstring required

BILL-generated ID of the recurring invoice. The value begins with rit.

customerIdstring

BILL-generated ID of the customer. The value begins with 0cu.

paymentTermIdstring

descriptionstring

Recurring invoice line item description

archivedboolean

Set as true if the recurring invoice is archived

sendEmailboolean

Set as true to send an email to the customer when an invoice is created.

createdTimestring date-time

Created date and time

updatedTimestring date-time

Updated date and time