Skip to main content
WEBHOOK
BILLING_INVOICE_CREATED
{
  "event":       "BILLING_INVOICE_CREATED",
  "eventId":     "EVTJHLTPQH45SAP",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-06-01T00:00:00Z",
  "data": {
    "invoiceId":     "INVTEST000001AB",
    "invoiceNumber": "INV-2026-06-001",
    "type":          "MONTHLY",
    "amount":        49.99,
    "currency":      "USD",
    "periodStart":   "2026-06-01T00:00:00Z",
    "periodEnd":     "2026-06-30T23:59:59Z",
    "dueAt":         "2026-06-15T00:00:00Z"
  }
}

{}
Fires when FYATU generates a new billing invoice for your business. Monthly invoices are generated on the first of each month; setup invoices are generated when a new program is activated. View and pay invoices in the FYATU portal under Billing.

​
Event Type

BILLING_INVOICE_CREATED

​
Payload

{
  "event":       "BILLING_INVOICE_CREATED",
  "eventId":     "EVTJHLTPQH45SAP",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-06-01T00:00:00Z",
  "data": {
    "invoiceId":     "INVTEST000001AB",
    "invoiceNumber": "INV-2026-06-001",
    "type":          "MONTHLY",
    "amount":        49.99,
    "currency":      "USD",
    "periodStart":   "2026-06-01T00:00:00Z",
    "periodEnd":     "2026-06-30T23:59:59Z",
    "dueAt":         "2026-06-15T00:00:00Z"
  }
}

​
Payload Fields

FieldTypeDescription
invoiceIdstringUnique invoice identifier
invoiceNumberstringHuman-readable invoice number
typestringMONTHLY or SETUP
amountnumberInvoice amount in dollars
currencystringCurrency code (always USD)
periodStartstringISO 8601 start of the billing period — present for MONTHLY invoices only
periodEndstringISO 8601 end of the billing period — present for MONTHLY invoices only
dueAtstringISO 8601 payment due date
For the full event group documentation see Billing Events. 
{
  "event":       "BILLING_INVOICE_CREATED",
  "eventId":     "EVTJHLTPQH45SAP",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-06-01T00:00:00Z",
  "data": {
    "invoiceId":     "INVTEST000001AB",
    "invoiceNumber": "INV-2026-06-001",
    "type":          "MONTHLY",
    "amount":        49.99,
    "currency":      "USD",
    "periodStart":   "2026-06-01T00:00:00Z",
    "periodEnd":     "2026-06-30T23:59:59Z",
    "dueAt":         "2026-06-15T00:00:00Z"
  }
}

{}

Authorizations

​
Authorization
string
header
required

API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.

Body

application/json
​
event
string
Example:

"BILLING_INVOICE_CREATED"

​
eventId
string
​
businessId
string
​
environment
enum<string>
Available options:
LIVE,
SANDBOX
​
timestamp
string<date-time>
​
data
object

Response

200

Acknowledge the event.