Authentication
Create a key in Settings → API keys (paid plans) and send it on every request. A key acts as the person who created it.
Authorization: Bearer b2b_…
- Base URL: https://b2blead.app/api/v1
- Rate limit: 120 requests per minute per account (HTTP 429 when exceeded)
- Errors are JSON: { "error": "…", "code": "…" }
List contacts
GET https://b2blead.app/api/v1/contacts?q=acme&status=replied&limit=100
- q — optional search across name, company, email, phone and notes
- status — optional: new, contacted, replied, qualified, closed, not_interested
- limit — 1 to 500, default 100
{
"total": 1,
"contacts": [
{
"id": "acme::jane doe",
"fullName": "Jane Doe",
"jobTitle": "Head of Sales",
"email": "jane@acme.com",
"phone": "+44 7700 900123",
"company": "Acme",
"website": "acme.com",
"status": "replied",
"lastEmailedAt": "2026-11-10T09:00:00.000Z",
"updatedAt": "2026-11-12T10:00:00.000Z"
}
]
}Add a contact
POST https://b2blead.app/api/v1/contacts
Content-Type: application/json
{
"company": "Acme",
"fullName": "Jane Doe",
"email": "jane@acme.com",
"jobTitle": "Head of Sales",
"website": "acme.com",
"status": "new",
"notes": "Met at the trade show"
}company and fullName are required. Returns 201 with the new id, or 200 when the contact already existed and was updated.
List sequences
GET https://b2blead.app/api/v1/sequences
Returns each email sequence with its steps and the number of contacts active in it.