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
| Header | Description |
|---|---|
Content-Type | application/json |
X-Requidex-Event | invoice_posted |
X-Requidex-Event-Id | Unique event delivery ID |
X-Requidex-Signature | HMAC SHA-256 signature of the raw request body |
X-Requidex-Timestamp | UTC timestamp used when signing the payload |
See signature verification and retry behavior for the shared delivery contract.
Payload Fields
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Unique event ID |
type | string | Yes | invoice_posted |
createdAt | string | Yes | Event timestamp in ISO 8601 format |
data.invoice.id | string | Yes | Full object ID |
Payload Example
{
"id": "evt_01K1WEBHOOKEXAMPLE",
"type": "invoice_posted",
"createdAt": "2026-09-10T12:00:00.000Z",
"data": {
"invoice": {
"id": "507f1f77bcf86cd799439013"
}
}
}