Welcome to RocketLead

RocketLead API Documentation.

Introduction

RocketLead is the most powerful platform for automating your WhatsApp outreach at scale. Manage campaigns, conversations, and accounts across hundreds of WhatsApp numbers — all through intelligent automation.

With RocketLead, you can:

Automate campaigns — Build multi-step WhatsApp sequences with A/B testing, delays, conditions, and smart reply detection

Manage accounts at scale — Provision, warm up, and operate hundreds of WhatsApp accounts from a single workspace

Organize leads — Import, tag, and segment leads into lists for targeted outreach

Handle conversations — Unified inbox for all your WhatsApp conversations with scheduling, tagging, and bulk actions

Deploy AI agents — Configure AI-powered agents with custom prompts, tone, and knowledge bases to auto-respond to leads

Track everything — Real-time analytics on delivery, read rates, replies, and credit usage

Getting Started

Authentication

All API requests require authentication via an API key passed in the x-api-key header.

To get your API key:

Navigate to Settings → API Keys

Click Create API Key and give it a name

Copy the key and store it securely — it won't be shown again

Example request:

Tip: You can also authenticate using an OAuth Bearer token via the Authorization: Bearer <token> header.

Base URL

All API requests should be made to:

https://api.rocketlead.com/api/v1

Response Format

All successful responses are wrapped in a standard envelope:

{
  "ok": true,
  "data": {
    // response payload
  }
}

Error responses follow the same structure:

{
  "ok": false,
  "error": {
    "message": "Description of what went wrong"
  }
}

Rate Limits & Fair Usage

Rate limits depend on your plan tier. When you exceed the limit, you'll receive a 429 Too Many Requests response. Implement exponential backoff and batch operations where possible.

Rate limit headers are included in every response:

x-ratelimit-limit: 10000
x-ratelimit-remaining: 9987
x-ratelimit-reset: 1678900000

Plan	Numbers	Price	Requests/min	Requests/day
Starter	1–25	$99/number/mo	10,000	250,000
Growth	26–100	$89/number/mo	20,000	500,000
Scale	101–999	$79/number/mo	30,000	1,000,000
Custom	1,000+	Custom	50,000	5,000,000

Core Resources

Resource	Description
Accounts	Provision, connect, and manage WhatsApp accounts
Campaigns	Create and run multi-step outreach sequences
Leads	Manage contacts with tags, custom fields, and bulk operations
Lead Lists	Organize leads into lists for campaign targeting
Conversations	Unified inbox — send messages, schedule, and tag conversations
Agents	Configure AI agents with custom prompts and knowledge bases
Warmup	Monitor and control account warmup progress
Credits	Check balance and view transaction history
Orders	Bulk-provision new WhatsApp accounts
Knowledge Base	Manage AI agent knowledge sources
Settings	Configure workspace preferences and webhooks

Quick Start

1. List your accounts

2. Create a lead list and import leads

3. Create and launch a campaign

4. Check your inbox

Need Help?

Support: support@rocketlead.com

Dashboard: app.rocketlead.com

Welcome to RocketLead

Welcome to RocketLead#

Introduction#

Getting Started#

Authentication#

Base URL#

Response Format#

Rate Limits & Fair Usage#

Core Resources#

Quick Start#

1. List your accounts#

2. Create a lead list and import leads#

3. Create and launch a campaign#

4. Check your inbox#

Need Help?#

Welcome to RocketLead

Introduction

Getting Started

Authentication

Base URL

Response Format

Rate Limits & Fair Usage

Core Resources

Quick Start

1. List your accounts

2. Create a lead list and import leads

3. Create and launch a campaign

4. Check your inbox

Need Help?