Webhooks
What it does
Webhooks let you send lead data to any URL in real time. Use them to connect Buska to internal tools, custom pipelines, or any service that accepts HTTP POST requests. Webhooks are the foundation for connecting Buska to Make, n8n, Clay, and any other automation platform.
Plan required: Growth, Scale
How it works
- Buska detects and qualifies a new lead
- Buska sends a JSON POST request to your webhook URL
- Your endpoint receives the full lead payload with all fields
- Your system processes the lead (route to CRM, trigger outreach, log to database, etc.)
Setup steps
- Go to Settings > Integrations in Buska
- Click "Add Webhook"
- Enter your endpoint URL (must accept POST requests)
- Optional: add a custom header for authentication (e.g.,
Authorization: Bearer your-token) - Click "Test" to send a sample payload and verify your endpoint responds with 200
Full JSON payload
Buska sends a JSON POST request to your endpoint for every new lead. Here is the full payload structure:
json
{
"event": "new_lead",
"timestamp": "2026-03-14T10:15:00Z",
"lead": {
"name": "John Doe",
"channel": "linkedin",
"intent": "ACTIVE",
"aiScore": 8,
"aiReason": "Shows intent to buy CRM solution",
"icpMatch": "CTO",
"contentPreview": "Looking for a better CRM...",
"postUrl": "https://...",
"link": "https://linkedin.com/in/...",
"keyword": "CRM",
"publishedAt": "2026-03-14T09:00:00Z"
},
"enriched": {
"email": "john@company.com",
"phone": "+1234567890",
"fullName": "John Doe",
"company": "Acme Corp",
"title": "CTO",
"linkedinUrl": "https://linkedin.com/in/johndoe"
}
}Data mapping
| Buska field | JSON path |
|---|---|
| Lead name | lead.name |
| Platform | lead.channel |
| Intent type | lead.intent |
| AI score (0-10) | lead.aiScore |
| AI reasoning | lead.aiReason |
| ICP match | lead.icpMatch |
| Content preview | lead.contentPreview |
| Post URL | lead.postUrl |
| Profile URL | lead.link |
| Keyword | lead.keyword |
| Published date | lead.publishedAt |
| Email (enriched) | enriched.email |
| Company (enriched) | enriched.company |
| Title (enriched) | enriched.title |
Use webhooks to connect Buska to any tool. For example, create a Make scenario that receives the webhook, checks the AI score, and routes leads to different tools based on their intent type. Or use an n8n workflow to filter leads by platform and push only LinkedIn leads to your CRM.
Related guides
- IntegrationsMake.comConnect Buska to Make.com (Integromat) for visual no-code automation. Receive new leads, transform data, and send to 1000+ apps.
- Integrationsn8nUse Buska with self-hosted n8n for fully controlled workflow automation. Receive leads via webhook, transform them, and route to any system.
- API ReferencePOST /v1/mentions/searchSearch social media mentions on a specific platform. Returns posts with content, author, URL, engagement. Used for real-time lead scraping.