Skip to main content
This guide assumes you already have a business secret key (tyms_sk_...) from useadam.io → Settings → Business settings → API. Partners provisioning new businesses should start with Partners and Register business.

​
Prerequisites

  • A qualifying Developer API subscription for the business (see Authentication).
  • curl, or any HTTP client that can set custom headers.

​
Step 1: Validate your key

Confirm the key is valid and read back business profile fields (currency, country, timezone, etc.). 
curl -sS -X GET "https://api.useadam.io/v1/adam/auth/validate" \
  -H "X-API-Key: YOUR_TYMS_SK_SECRET"
Success responses use the shape documented on Validate business. 401 means the key is wrong or missing; 403 usually means the business is not allowed to use the Developer API yet.

​
Step 2: Create a record with AI (optional)

Most create routes expect a JSON body with at least prompt. By default, processing is async; set process_type to direct if you need the work to finish in the same HTTP round-trip (slower). 
curl -sS -X POST "https://api.useadam.io/v1/adam/invoices" \
  -H "X-API-Key: YOUR_TYMS_SK_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Create an invoice for ACME LLC for $250 for consulting, dated today, due in 14 days"
  }'
See AI prompt guidelines, Create invoice (AI) in the API reference tab, and Attachments.

​
Step 3: Pull structured data

List resources with pagination and ordering, then get by uuid or source_uuid where supported. 
curl -sS -G "https://api.useadam.io/v1/adam/invoices" \
  -H "X-API-Key: YOUR_TYMS_SK_SECRET" \
  --data-urlencode "page=1" \
  --data-urlencode "limit=20"

​
Next steps

  • Read Concepts for the mental model (AI vs REST, reports, identifiers).
  • Use the API reference tab for every endpoint, query parameter, and body field.
  • Partners: Partners → Register business.