---

--- title: "How to Build a Wafeq API Integration" description: "A developer guide to the Wafeq accounting API: authentication, invoices, contacts, error handling, and ZATCA webhooks for KSA." author: "GJ" published: "2026-05-04T10:00:00+00:00" updated: "2026-05-04T13:37:57.852Z" url: "https://www.apideck.com/blog/wafeq-api-integration" category: "Accounting" tags: ["Accounting", "Industry insights"] --- # How to Build a Wafeq API Integration Saudi Arabia made e-invoicing mandatory in 2021 under ZATCA regulations. The UAE followed with its own FTA e-invoicing rollout. If you're building a product that handles money for businesses in the Gulf, you will run into customers on Wafeq. Wafeq processed over 2 million invoices worth $400 million every month as of its November 2024 Series A, with roughly 90% of that volume coming from Saudi Arabia. That concentration tells you most of the traction is in the market with the strictest compliance requirements. Notable customers include Tabby and Platinumlist, category-defining companies in MENA fintech and ticketing. If your product touches their accounting layer, a Wafeq API integration will come up. This guide covers authentication with the Wafeq accounting API, the core data model, contact and invoice creation, idempotency, webhooks, and where to route KSA Phase 2 traffic separately. ## Authentication Wafeq supports two authentication methods: API key and OAuth2. For internal tools or direct integrations where your company manages its own Wafeq workspace, API key auth is the simpler path. You pass the key as a header on every request: ``` Authorization: Api-Key

---