Quickstart

This quickstart gets you up and running with the Umbra ERP API. We will cover how to authenticate and make your first request to retrieve sales quotes.

Log in to the Umbra ERP dashboard at app.umbraerp.com to manage your account. API access is available to all authenticated users.

Install your preferred HTTP client

Umbra ERP provides a simple REST API. You can use any HTTP client in any language. Here are some options:

# cURL is most likely already installed on your machine
curl --version

Making your first API request

First, authenticate to get a JWT token, then use it to list sales quotes.

POST

/v1/auth/login

# Step 1: Get your access token
TOKEN=$(curl -s -X POST https://api.umbraerp.com/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com", "password": "your_password"}' \
  | jq -r '.accessToken')

# Step 2: List sales quotes
curl https://api.umbraerp.com/v1/sales/quotes \
  -H "Authorization: Bearer $TOKEN"

Read the full Sales & Invoicing documentation

What's next?

After your first call, explore these sections:

Authentication -- Learn about JWT token management
Sales & Invoicing -- Manage quotes, invoices, and the sales pipeline
CRM -- Manage leads and customer relationships
Webhooks -- Receive real-time event notifications