Introduction

Welcome to the Lead Hero API documentation. Use this reference to integrate with the Lead Hero platform and automate your lead management workflows.

Base URL

https://api.leadhero.io

Authentication

All API requests require an organization API key. You can pass it in two ways:

Bearer Token (recommended)

Authorization: Bearer <your-api-key>

Header

x-api-key: <your-api-key>

Getting Your API Key

1. Log in to app.leadhero.io
2. Navigate to Settings → API Keys
3. Create a new API key and copy it

Rate Limiting

API requests are rate-limited per IP. When you exceed 120 requests within a 30-second window, the API returns a 429 Too Many Requests response.

Response Format

All responses are JSON. Successful responses include the requested data. Error responses include an error field with a human-readable message.

{
   "error": "Unauthorized",
   "message": "Invalid or missing API key"
}

Next Steps

• Browse the API Reference
• Examples - common actions as ready-to-run requests
• Authentication details
• SMS vs. iMessage - which channel to use and what each requires