ONIMAIL/ API Reference v1

ONIMAIL REST API

Full programmatic access to your email, CRM, Drive, bookings and organization. All endpoints require an API key.

Authentication

# Pass your API key via Authorization header
curl https://mail.nexafoundry.ai/api/v1/me \
  -H "Authorization: Bearer oni_live_xxxxxxxx"

# Or via header
curl https://mail.nexafoundry.ai/api/v1/me \
  -H "X-API-Key: oni_live_xxxxxxxx"

Authentication

Email

CRM — Contacts

CRM — Deals

CRM — Tasks

Drive — Documents

Booking

Organization

Rate limits & errors

Standard errors

401 — Missing or invalid API key

400 — Bad request / missing field

403 — Feature not available on current plan

404 — Resource not found

500 — Internal server error

SDK example (JavaScript)

const res = await fetch('/api/v1/contacts', {
  headers: {
    'Authorization': 'Bearer oni_live_xxx',
    'Content-Type': 'application/json'
  }
})
const { contacts } = await res.json()