Quickstart

This quickstart takes you from zero to a synced expense. Building Kenyan tax compliance instead? Jump to the eTIMS quickstart.

Get your API key

sk_development_x9y8z7...

Full details — including the optional request signature — are in Authentication.

Create a company

A company represents your SMB customer.

curl -X POST "https://api.sync2books.com/companies" \
  -H "X-API-Key: sk_development_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme Corporation" }'

The response includes the company id and an authUrl to connect an accounting system. See Companies & connections.

Connect an accounting system

Use the Link component (recommended) or open the authUrl in a browser and complete the OAuth flow. Then list the company’s connections to get the connectionId:

curl -X GET "https://api.sync2books.com/connections/company/{companyId}" \
  -H "X-API-Key: sk_development_your_api_key"

Sync your first expense

curl -X POST "https://api.sync2books.com/expenses/{connectionId}" \
  -H "X-API-Key: sk_development_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "exp-001",
    "type": "Payment",
    "issueDate": "2024-01-15T00:00:00Z",
    "currency": "USD",
    "currencyRate": 1,
    "merchantName": "Amazon",
    "lines": [
      {
        "netAmount": 100.00,
        "taxAmount": 10.00,
        "taxRateRef": { "id": "tax-rate-id" },
        "accountRef": { "id": "account-id" }
      }
    ]
  }'

{ "syncBatchId": "550e8400-e29b-41d4-a716-446655440000", "totalExpenses": 1 }

Confirm the sync

Writes are asynchronous — check the batch to see the result:

curl -X GET "https://api.sync2books.com/sync/batches/{syncBatchId}" \
  -H "X-API-Key: sk_development_your_api_key"

See The sync model for statuses and error handling.

What’s next

Expenses guide

Map transactions, configure customers, and upload receipts.

eTIMS quickstart

From sign-up to your first KRA-signed receipt.

Get started

Core concepts

Expenses

eTIMS compliance (Kenya)

Accounting integrations

Link component

What’s next

Expenses guide

eTIMS quickstart

​What’s next

Expenses guide

eTIMS quickstart

What’s next