billing_client.created
A client you invoice was added.
{
"id": "evt_01M3VBXRH0YXGN5AXNN51E66VA",
"type": "billing_client.created",
"timestamp": "2026-10-01T09:15:00.000Z",
"apiVersion": "2026-10-01",
"organisationId": "org-test-1",
"customerId": "customer-test-1",
"livemode": true,
"data": {
"eventType": "billing_client.created",
"organisationId": "org-test-1",
"clientId": "client-001",
"name": "Example Client Ltd",
"status": "Active",
"vatNumber": null,
"registrationNumber": null,
"contacts": null,
"billingAddress": null,
"physicalAddress": null,
"occurredAt": "2026-10-01T09:15:00Z",
"resourceUrl": "https://api.flowpayroll.ai/v1/billing/clients/client-001"
},
"metadata": {
"resourceUrl": "https://api.flowpayroll.ai/v1/billing/clients/client-001",
"correlationId": "01K6B3N8Z4Q2W7X5Y9T1V3M6RA",
"documentUrl": null,
"payloadStyle": "Full",
"payloadDowngraded": false,
"dateFormat": "yyyy-MM-dd",
"dateTimeFormat": "yyyy-MM-ddTHH:mm:ss.fffZ"
}
}Authorizations
FlowPayroll JWT (raw token, no Bearer prefix)
Headers
Unique id for this message. Use it as an idempotency key.
Unix seconds when this attempt was signed. Reject anything outside a five-minute tolerance to prevent replay.
Space-delimited signatures over {id}.{timestamp}.{body}: every v1,{base64} HMAC-SHA256 entry, then every v1a,{base64} ed25519 entry. Verify v1a with the endpoint's public key, which we recommend because a receiver holding only a public key cannot sign events, or v1 with the signing secret, comparing in constant time. More than one of each appears during a secret rotation; accepting any match rotates with no downtime.
The event type, for routing without parsing the body.
The organisation this event belongs to.
The customer that owned the organisation when the event happened. Present on every delivery, and the routing key for a customer-scoped endpoint.
Our id for this delivery. Quote it in a support request.
1-based attempt counter.
Correlation id threaded through every FlowPayroll service.
Body
The signed event envelope. The body is byte-identical across every delivery attempt; verify the signature against these raw bytes.
Response
Any 2xx acknowledges receipt. Respond quickly and do the work asynchronously: an attempt that has not finished within 15 seconds counts as failed.
Was this page helpful?
{
"id": "evt_01M3VBXRH0YXGN5AXNN51E66VA",
"type": "billing_client.created",
"timestamp": "2026-10-01T09:15:00.000Z",
"apiVersion": "2026-10-01",
"organisationId": "org-test-1",
"customerId": "customer-test-1",
"livemode": true,
"data": {
"eventType": "billing_client.created",
"organisationId": "org-test-1",
"clientId": "client-001",
"name": "Example Client Ltd",
"status": "Active",
"vatNumber": null,
"registrationNumber": null,
"contacts": null,
"billingAddress": null,
"physicalAddress": null,
"occurredAt": "2026-10-01T09:15:00Z",
"resourceUrl": "https://api.flowpayroll.ai/v1/billing/clients/client-001"
},
"metadata": {
"resourceUrl": "https://api.flowpayroll.ai/v1/billing/clients/client-001",
"correlationId": "01K6B3N8Z4Q2W7X5Y9T1V3M6RA",
"documentUrl": null,
"payloadStyle": "Full",
"payloadDowngraded": false,
"dateFormat": "yyyy-MM-dd",
"dateTimeFormat": "yyyy-MM-ddTHH:mm:ss.fffZ"
}
}