REST API v1

Axia REST API

Build custom integrations, automate workflows, and extend your CRM with a fully documented, RESTful interface. Everything you need to programmatically access leads, contacts, deals, and analytics.

Get Your API KeyView Endpoints
Base URLhttps://api.axiacrm.com/v1
Authentication

Secure by default

All API requests require authentication. Choose the method that fits your integration architecture.

API Key Authentication

Best for server-to-server integrations. Generate keys in your dashboard and pass them via the Authorization header.

Authorization: Bearer YOUR_API_KEY

OAuth 2.0

Recommended for user-facing applications. Implements the standard authorization code flow with PKCE support.

GET /oauth/authorize?client_id=...&scope=read+write

Rate Limiting

Pro Plan1,000requests / min
Enterprise Plan5,000requests / min
Endpoints

API Reference

Every resource in your CRM is accessible through a consistent, predictable REST interface. All paths are relative to the base URL.

Leads5 endpoints
GET/leads
List all leads with pagination and filtering
POST/leads
Create a new lead record
GET/leads/:id
Retrieve a single lead by ID
PUT/leads/:id
Update an existing lead
DELETE/leads/:id
Delete a lead permanently
Contacts4 endpoints
GET/contacts
List all contacts with search and filters
POST/contacts
Create a new contact
GET/contacts/:id
Retrieve a contact by ID
PUT/contacts/:id
Update contact details
Deals5 endpoints
GET/deals
List all deals across pipeline stages
POST/deals
Create a new deal
GET/deals/:id
Retrieve a deal by ID
PUT/deals/:id
Update deal stage, value, or details
GET/deals/:id/activities
List activities linked to a deal
Activities3 endpoints
GET/activities
List all activities (calls, emails, meetings)
POST/activities
Log a new activity
GET/activities/:id
Retrieve a specific activity
Users2 endpoints
GET/users
List all team members
GET/users/me
Get the authenticated user profile
Analytics3 endpoints
GET/analytics/pipeline
Pipeline stage distribution and velocity
GET/analytics/revenue
Revenue totals, forecasts, and trends
GET/analytics/conversion
Lead-to-deal conversion metrics
Quick Start

Code Examples

Get up and running in seconds. Here is how to fetch your leads using the Axia API.

curl -X GET https://api.axiacrm.com/v1/leads \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Webhooks

Real-time event notifications

Subscribe to webhook events to receive HTTP POST callbacks whenever key actions occur in your CRM. All payloads are signed with HMAC-SHA256.

Event Type
lead.createdFired when a new lead is added to the system
lead.updatedFired when any lead field is modified
deal.wonFired when a deal is moved to the Won stage
deal.lostFired when a deal is marked as Lost
activity.createdFired when a call, email, or meeting is logged
SDKs

Official client libraries

Use our typed client libraries to integrate faster. Handles authentication, pagination, error handling, and retries out of the box.

JavaScript / TypeScript

Available
npm install @axia/sdk

Full TypeScript support with auto-generated types for every resource. Works in Node.js, Deno, Bun, and edge runtimes.

Python

Coming Soon
pip install axia-sdk

Async-first Python client with Pydantic models, automatic rate-limit handling, and full type annotations.

Start building with the Axia API

Generate your API key in the dashboard and make your first request in under a minute. Full access on every plan.

Get Your API Key