REST API v1

API ReferenceBuild anything with Leadify.

A fully RESTful API with webhooks, SDKs for every major language, and OAuth 2.0 authentication. Everything you need to integrate Leadify into your stack.

Base URL:api.leadifylabs.com/v1
terminal
$ |
// Response (200 OK)
{
"data": [{
"id": "ct_93x",
"name": "Jane Doe",
"email": "jane@acme.co"
}]
}

Quick Overview

Enterprise-grade API built for reliability, speed, and security.

0+
Endpoints
Comprehensive coverage
0.99%
Uptime
Industry-leading SLA
<0ms
Latency
Median response time
OAuth 2.0
Auth
Secure by default

Authentication

Three flexible auth methods to fit your integration needs.

curl
curl -X GET "https://api.leadifylabs.com/v1/contacts" \
  -H "Authorization: Bearer sk_live_abc123..." \
  -H "Content-Type: application/json"

Core Endpoints

Six resource groups covering every CRM operation.

12 endpoints

Contacts

Manage leads, customers, and organizations

/v1/contacts
GETPOSTPUTDELETE
10 endpoints

Deals

Track opportunities through your pipeline

/v1/deals
GETPOSTPUTDELETE
8 endpoints

Pipelines

Configure stages and pipeline workflows

/v1/pipelines
GETPOSTPUT
9 endpoints

Activities

Log calls, emails, meetings, and tasks

/v1/activities
GETPOSTPUTDELETE
6 endpoints

Users

Manage team members, roles, and permissions

/v1/users
GETPOSTPUT
5 endpoints

Webhooks

Subscribe to real-time event notifications

/v1/webhooks
GETPOSTDELETE

API Playground

Test endpoints interactively without writing a single line of code.

https://api.leadifylabs.com
Response
Click "Send" to make a request...
Integration APIs

Connect Your Stack

Real API endpoints to connect Leadify with the tools your team already uses. Every integration includes authentication, CRUD operations, and webhook events.

14+Integrations
OAuth 2.0Auth Methods
SyncBi-directional
3 LanguagesCode Samples

How Integrations Work

Every integration follows the same pattern: authenticate, configure sync rules, then data flows automatically.

Authenticate
OAuth 2.0 or API Key
Configure
Map fields & set rules
Sync
Real-time data flow
Automate
Webhooks & triggers

Webhooks

Get real-time notifications when events happen in your Leadify account.

contact.created

Triggered when a new contact is added

{ "event": "contact.created", "data": { "id": "ct_93x", "name": "Jane Doe", "email": "jane@acme.co" } }
deal.updated

Triggered when a deal field changes

{ "event": "deal.updated", "data": { "id": "dl_47k", "stage": "Negotiation", "value": 25000 } }
deal.won

Triggered when a deal is marked won

{ "event": "deal.won", "data": { "id": "dl_47k", "value": 25000, "won_at": "2026-04-12T10:00:00Z" } }
deal.lost

Triggered when a deal is marked lost

{ "event": "deal.lost", "data": { "id": "dl_52m", "reason": "Budget constraints" } }
activity.logged

Triggered when an activity is recorded

{ "event": "activity.logged", "data": { "id": "ac_81n", "type": "call", "duration": 340 } }
user.invited

Triggered when a team member is invited

{ "event": "user.invited", "data": { "id": "us_19p", "email": "new@team.co", "role": "member" } }

Rate Limits

Generous limits that scale with your plan.

Free100 req/min
Pro1,000 req/min
Enterprise10,000 req/min

Rate Limit Response Headers

X-RateLimit-LimitMaximum requests allowed per window
X-RateLimit-RemainingRequests remaining in current window
X-RateLimit-ResetUnix timestamp when the window resets
Retry-AfterSeconds to wait before retrying (only on 429)

SDKs & Libraries

Official client libraries for every major language.

JS
v3.2.1

JavaScript / TypeScript

npm install @leadify/sdk
42.5k/week
GitHub
PY
v2.8.0

Python

pip install leadify-sdk
38.1k/week
GitHub
RB
v1.5.3

Ruby

gem install leadify
12.3k/week
GitHub
PHP
v2.1.0

PHP

composer require leadify/sdk
18.7k/week
GitHub
GO
v1.4.2

Go

go get github.com/leadify/go-sdk
9.8k/week
GitHub
JV
v2.0.1

Java

implementation 'com.leadify:sdk:2.0.1'
15.2k/week
GitHub

Error Codes

Predictable error responses to help you debug faster.

400

Bad Request

The request body is malformed or missing required fields.

{ "error": { "code": "bad_request", "message": "Field 'email' is required." } }
401

Unauthorized

Authentication credentials are missing or invalid.

{ "error": { "code": "unauthorized", "message": "Invalid API key provided." } }
403

Forbidden

The API key does not have permission for this action.

{ "error": { "code": "forbidden", "message": "Insufficient permissions to delete contacts." } }
404

Not Found

The requested resource does not exist.

{ "error": { "code": "not_found", "message": "Contact ct_93x not found." } }
429

Rate Limited

Too many requests. Retry after the window resets.

{ "error": { "code": "rate_limited", "message": "Rate limit exceeded. Retry after 60s." } }
500

Server Error

An unexpected error occurred on our end.

{ "error": { "code": "internal_error", "message": "Something went wrong. Our team has been notified." } }
Developer Platform

Start Building Today

Get your API key in under a minute. Full access to every endpoint with our generous free tier.

Free tier includes 100 requests/min, all endpoints, and community support.