Skip to main content

Invoice Posted

Event Type​

invoice_posted

Company and agency webhooks are supported. Agency delivery is restricted to records belonging to that agency. MSP-to-client records are excluded from agency delivery.

When It Fires​

Sent when an invoice is explicitly posted to finance through the portal, an import, or the Open API. Repeating the posted status does not send another event. Marking an invoice paid sends invoice_paid only. Draft invoices and applications for payment (AFPs) do not send invoice events. Company webhooks receive events for their records; agency delivery is limited to records belonging to that agency. MSP-to-client records are excluded from agency delivery. Fetch full details from GET /invoices/{id}.

Fetch the Full Object​

The payload contains the full object ID in data.invoice.id. Fetch the record with GET /invoices/{id}.

Delivery​

  • Method: POST
  • Content-Type: application/json
  • Delivery guarantee: at-least-once

Delivery Headers​

HeaderDescription
Content-Typeapplication/json
X-Requidex-Eventinvoice_posted
X-Requidex-Event-IdUnique event delivery ID
X-Requidex-SignatureHMAC SHA-256 signature of the raw request body
X-Requidex-TimestampUTC timestamp used when signing the payload

See signature verification and retry behavior for the shared delivery contract.

Payload Fields​

FieldTypeRequiredDescription
idstringYesUnique event ID
typestringYesinvoice_posted
createdAtstringYesEvent timestamp in ISO 8601 format
data.invoice.idstringYesFull object ID

Payload Example​

{
"id": "evt_01K1WEBHOOKEXAMPLE",
"type": "invoice_posted",
"createdAt": "2026-09-10T12:00:00.000Z",
"data": {
"invoice": {
"id": "507f1f77bcf86cd799439013"
}
}
}