API Docs

Webhook Request Format

Marmin will send POST requests to your webhook URL with the following structure.

Headers

x-marmin-signature: HMAC-SHA256 signature of the request payload.
Content-Type: application/json.

Field Description

Field	Description
`org_id`	UUID of the organization that owns the document
`event_type`	Event type that triggered the webhook (for example, `sale.invoice.update`)
`profile_id`	Business profile identifier associated with the event
`resource_id`	UUID of the document (same as the document object's `id` field)
`resource_url`	API URL to fetch the latest document state
`event_timestamp`	ISO 8601 timestamp when the event occurred
`webhook_event_id`	Unique UUID for the webhook event delivery

Payload Structure

Each webhook request contains a minimal payload describing the affected document:

{
  "org_id": "80d3cd7d-25ff-4d49-a60c-5d30a0026692",
  "event_type": "sale.invoice.update",
  "profile_id": "MBP-46ETA0X3DI",
  "resource_id": "15dd7668-5462-4998-8813-c71f1395c869",
  "resource_url": "https://api-sandbox.ae.marmin.ai/api/sales-invoices/15dd7668-5462-4998-8813-c71f1395c869",
  "event_timestamp": "2026-04-14T04:31:31.064Z",
  "webhook_event_id": "d3f1bfa2-b445-4b38-b0db-67dcd9b23baa"
}

Note: The resource_id is the document's UUID (same as the id field on the document object). Use the resource_url to fetch the latest document state via a GET request.