n8n Integration

Use n8n when you need custom orchestration and branch logic between internal tools and Figa.

1. 1

   Create API key in workspace settings (owner/admin only).

2. 2

   In n8n, define credential as HTTP Header Auth: x-api-key = et_...

3. 3

   Add HTTP Request node to GET /api/v1/categories and verify connectivity.

4. 4

   Build flow for source event (invoice, CRM, webhook) and map payload to POST /api/v1/expenses.

5. 5

   Handle 403/409 responses with retry or fallback branch.

Minimal node payload

{
  "name": "Invoice #481",
  "amount": 129900,
  "categoryInput": "Software",
  "recipientInput": "Acme Corp",
  "expenseDate": 1739577600
}