Start Here

AskElephant Developer Docs

Integration-first docs for the current public API surface

View as Markdown

AskElephant’s public API is designed for CRM sync, contact enrichment, and downstream automation. These docs focus on the current contract and the fastest path to a working integration.

Start here

  1. Generate or receive a bearer token or API key for a workspace.
  2. Make a first authenticated request to GET /api/v2/contacts.
  3. Expand to companies, users, tags, or engagements once auth is working.
  4. Use the returned next_cursor to continue pagination on cursor-based collections.
  5. Handle 401, 403, 404, and 429 explicitly using the problem+json payload.

What the live API guarantees

  • Base path /api with URL major versioning in each route, such as /v2/contacts
  • snake_case response fields
  • Cursor pagination on collection endpoints
  • application/problem+json errors with a request_id
Quickstart

Make your first authenticated contacts request.

Authentication

Choose bearer tokens or API keys and send the right header.

API reference overview

See the current endpoint surface and contract shape.

Source of truth

Use the API Reference tab for endpoint details, request shapes, and response schemas.