Skip to main content
This guide assumes you already have a business secret key (tyms_sk_...) from the Tyms app → Settings → Business settings → API. Partners provisioning new businesses should start with Partners and Register business.
Integrating before go-live? Use the sandbox environment at https://staging-api.usetyms.com/v1/adam. Email developer@usetyms.com to get a sandbox account and staging keys — app-issued production keys are not valid on staging.

​
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.usetyms.com/v1/adam/auth/validate" \
  -H "X-API-Key: YOUR_TYMS_SK_SECRET"

const res = await fetch('https://api.usetyms.com/v1/adam/auth/validate', {
  headers: { 'X-API-Key': 'YOUR_TYMS_SK_SECRET' },
});
const body = await res.json();
console.log(body);

import requests

r = requests.get(
    "https://api.usetyms.com/v1/adam/auth/validate",
    headers={"X-API-Key": "YOUR_TYMS_SK_SECRET"},
)
print(r.json())
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.usetyms.com/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.usetyms.com/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.