Invoice event notification

Post

/webhooks/invoice-events

This is not an endpoint you call. This documents the webhook payload MakersHub sends to your configured webhook URL when invoice lifecycle events occur.

All notifications are POST requests with a JSON body containing an eventNotification object. Configure your webhook URL in MakersHub settings to receive these notifications.

Operations

Operation	Description
`Approved`	Invoice was approved.
`Combined`	Invoice group was combined into a single invoice.
`Created`	Invoice was created.
`Deleted`	Invoice was deleted.
`Merged`	Invoice was merged. Includes `context` with `mergeFromId` and `mergeToId`.
`Processed`	Invoice was processed (OCR extraction completed).
`Rejected`	Invoice was rejected.
`Updated`	Invoice was updated.

Signature Verification

If a webhook signature secret is configured, the X-Signature header contains an HMAC-SHA256 signature of the request body. Verify it by computing hash_hmac('sha256', $body, $secret) and comparing.

Body parameters

approved

Invoice Approved

{
  "eventNotification": {
    "cid": 1001,
    "name": "Invoice",
    "id": 12345,
    "operation": "Approved",
    "timestamp": "2026-02-19T14:30:00Z"
  }
}

processed

Invoice Processed (OCR Complete)

{
  "eventNotification": {
    "cid": 1001,
    "name": "Invoice",
    "id": 12345,
    "operation": "Processed",
    "timestamp": "2026-02-19T14:30:00Z"
  }
}

merged

Invoice Merged (with context)

{
  "eventNotification": {
    "cid": 1001,
    "name": "Invoice",
    "id": 12345,
    "operation": "Merged",
    "context": {
      "mergeFromId": 12345,
      "mergeToId": 67890
    },
    "timestamp": "2026-02-19T14:30:00Z"
  }
}

Expand All

object

Payload sent to webhook URLs when invoice lifecycle events occur.

eventNotification

object

cid

integer Required

Company identifier.

name

string Required

Object type.

Valid values[ "Invoice", "Vendor" ]

integer Required

Object identifier.

operation

string Required

The event operation that occurred.

Valid values[ "Approved", "Combined", "Created", "Deleted", "Merged", "Processed", "Rejected", "Updated" ]

context

object | null

Additional context for the event. Only present for certain operations (e.g., Merged).

mergeFromId

integer

Source invoice ID that was merged from.

mergeToId

integer

Target invoice ID that was merged into.

timestamp

string (date-time) Required

ISO 8601 timestamp of the event.

Responses

200

Webhook received successfully