Server API

Use the server API when data lives on your server, in a CRM, or in a tool like Zapier. It works on its own or alongside the tracking snippet.

1. Get your API key

Go to Settings → Integrations → Server API & CRM and click Generate API key. The key starts with atlis_sk_ and is shown only once, so store it somewhere safe. Regenerate key replaces it, and the old key stops working immediately.

2. Create or update a user

POST /api/v1/identify creates the user if they're new, or updates them. Send it before any events for that user.

curl -X POST https://theatlis.com/api/v1/identify \
  -H "Authorization: Bearer atlis_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "12345",
    "email": "jane@company.com",
    "name": "Jane Smith",
    "plan": "pro",
    "isActivated": false,
    "trialExpiresAt": "2026-12-01T00:00:00Z",
    "signedUpAt": "2026-09-01T10:00:00Z",
    "properties": { "company": "Acme" }
  }'

A successful call returns 200 {"success": true}.

3. Send an event

POST /api/v1/events records something the user did. If a workflow for that trigger is switched on, its email sends.

curl -X POST https://theatlis.com/api/v1/events \
  -H "Authorization: Bearer atlis_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "12345",
    "eventName": "trial_started",
    "messageId": "trial_started_12345",
    "properties": { "plan": "pro" }
  }'

A successful call returns 200 {"ok": true}. The event time is the moment Atlis receives it. Events sent to this endpoint also count as activity, so they update the user's last active time.

Authentication

Code examples

// Node.js 18+ (uses the built-in fetch)
const ATLIS_KEY = process.env.ATLIS_API_KEY;

async function atlis(path, body) {
  const res = await fetch("https://theatlis.com/api/v1/" + path, {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + ATLIS_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(body),
  });
  if (!res.ok) throw new Error("Atlis " + res.status + ": " + (await res.text()));
  return res.json();
}

await atlis("identify", { userId: "12345", email: "jane@company.com", name: "Jane Smith" });
await atlis("events", { userId: "12345", eventName: "first_project_created" });

Responses and errors

Time-based emails for API users

• The Inactive 7/14 days, Testimonial request and Not activated in 48h workflows depend on activity. Atlis skips them for API users until it has real activity for them.
• Activity comes from /api/v1/events calls, a lastActiveAt value in identify, or the tracking snippet. Events sent inside an identify call (eventName) don't count as activity.
• For CRM leads with no product activity, you can still send the Not activated email: see CRM status mapping.
• Trial expiring in 3 days works for API users as long as you send trialExpiresAt.