Approvals

Changes that wait for an approver answer 202.

When an organisation has approval levels for something (Control › Approval levels: invoices over a limit, new customers, leave…), a change from the API waits for an approver just like one from the app's pages. You get 202 Accepted, and nothing is changed until it's approved.

{
  "status": "pending_approval",
  "message": "Sent for approval: it's made once it's approved.",
  "approval": {
    "id": "cm2x…",
    "status": "pending",
    "module": "salesInvoices",
    "action": "create",
    "recordId": "cm2w…",
    "summary": null,
    "currentLevel": 1,
    "levels": 2,
    "reason": null,
    "createdAt": "2026-10-17T09:30:00.000Z",
    "decidedAt": null
  }
}

The approvers get it in their bell, in every Zilo app. Then either:

• Ask: GET https://api.zilomail.in/v1/approvals/{id} says pending, approved or rejected (with the reason).
• Be told: the organisation's webhooks get approval.requested and approval.decided.