Developer Docs

Build on Acacia.

Acacia is an operating system with an open edge. Connect it, extend it, and pipe data through it with a clean, event-driven API.

API philosophy

A predictable, boring-in-the-best-way API: resource-oriented REST, events pushed to you over webhooks, and idempotent operations so retries are safe by default.

Resource-oriented REST over HTTPS with JSON
Event-driven: subscribe to webhooks instead of polling
Idempotent writes — a retried request never double-posts

What you can build

The API is the same surface Acacia's own integrations use, so what we build, you can build.

Integrations with your existing ERP, accounting, or logistics tools
Custom apps and internal tools on top of your Acacia data
Data pipelines into your warehouse or BI stack

Authentication

Authentication is token-based and scoped, so every integration gets exactly the access it needs and nothing more.

Scoped API tokens per integration
Least-privilege access by resource and action
Every API action captured in the audit trail

Illustrative — create an invoice

POST /v1/invoices
Authorization: Bearer sk_live_•••••••••••
Content-Type: application/json

{
  "customer_id": "cus_8H2K",
  "currency": "KES",
  "lines": [
    { "item": "itm_RICE25", "qty": 40, "price": 3200 }
  ],
  "etims": true,
  "deliver": ["whatsapp", "email"]
}

Response

201 Created

{
  "id": "inv_29Z",
  "status": "submitted",
  "etims": { "status": "accepted", "cu_invoice_no": "KRA••••" },
  "total": 128000,
  "payment_link": "https://pay.getacacia.co/inv_29Z"
}

Illustrative only — request a key for the live API reference.

Want to build on Acacia?

Tell us what you are building and we will get you API access.

Request API access