Developer Documentation
Integrate Weezly Outreach with your existing tools and workflows. Receive real-time event notifications via webhooks or interact with your data through the REST API.
Webhooks
Receive HTTP callbacks when events happen: replies, AI-detected interested leads, connections, campaign completions, and more.
REST API
Programmatically manage leads, campaigns, accounts, and pipeline with full CRUD operations.
Core Concepts
Authentication
All API requests require your API key in the X-API-KEY header. Webhook payloads are signed with HMAC-SHA256 using your webhook secret, sent in the X-Webhook-Signature header.
Event-Driven Architecture
Weezly Outreach uses an event-driven architecture. Webhooks fire in real-time as actions occur, no polling required. Events include campaign step completions, lead replies, AI-detected interested leads, connection acceptances, and more.
MCP Server
Connect AI agents
AI agents such as Claude, n8n, Make and Clay can work with your Weezly Outreach data through the Model Context Protocol (HTTP Streamable transport). Generate a key in Settings > Integrations > MCP Server and paste the connection URL shown there into your agent, it looks like https://your-domain.com/api/mcp?xMcpKey=mcp_.... A key can be scoped to one workspace, so the agent sees exactly that workspace's data. Regenerating the key invalidates the old URL.
The agent picks the right tool by itself. The tools can:
- Campaigns: list and inspect campaigns with their stats, see every lead in a campaign and where it is, and launch, pause, resume or stop a campaign (same checks as the app)
- Lead lists: list and read lead lists, create a list and add leads to it (including custom fields); a running campaign picks new leads up automatically
- Accounts: list your LinkedIn accounts with their health and daily limits
- Dashboard: read your dashboard numbers for any period
- Pipeline: list stages and contacts, and move a contact to another stage
- Conversations: list conversations, read a full thread, and list campaign replies with the AI interest verdict
- Messaging: send a LinkedIn message, with your daily limits and send spacing applied
- Lead search: search the lead database by title, company, country or city
Ready to get started?
Set up your first webhook in Settings → API, or explore the REST API to manage your data programmatically.