Invoices

contractor_invoice.payment_initiated

This event is triggered when an employer initiates payment on a contractor invoice for the first time (transition to pending_payment from issued or approved).

The payload is stateless. Use the contractor invoice ID and employment ID to retrieve current details.

postWebhookcontractor_invoice.payment_initiated

Payload

company_idstring required

The unique identifier of the related company.

contractor_invoice_idstring required

The unique identifier of the contractor invoice.

employment_idstring required

The unique identifier of the related employment.

event_typestring required

The webhook event type identifier.

Example payload

{
  "company_id": "123-example",
  "contractor_invoice_id": "123-example",
  "employment_id": "123-example",
  "event_type": "contractor_invoice.payment_initiated"
}

Response

Any 200 response confirms that the webhook was delivered.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.