API & webhooks

Lumis OS exposes a REST API for contacts, companies, opportunities, projects, and tasks. Webhooks let you push events to your own systems.

Authentication

Generate an API key from Settings → API & Webhooks. Treat it like a password — it has full access to your workspace data. Include it as a bearer token:

Authorization: Bearer YOUR_API_KEY

Base URL

https://lumisos.ai/api/public/v1

Example: list contacts

curl https://lumisos.ai/api/public/v1/contacts \
  -H "Authorization: Bearer YOUR_API_KEY"

Webhooks

Subscribe to events (contact created, deal won, task completed, etc.) and we'll POST a JSON payload to your URL. Every payload is signed — verify the x-lumis-signature header before trusting the contents.

Full endpoint reference is in Settings → API Docs.