Custom Webhooks Integration Guide
Automate Workflows with Linkzly Custom Webhooks
Linkzly's Custom Webhooks let you send events to any URL, with HMAC-SHA256 signing, custom headers, and retries for secure, reliable delivery. Perfect for Zapier/Make integrations or custom scripts, this powers automations like CRM updates on clicks. Production-grade with circuit breakers and rate limiting, it's your flexible bridge to endless possibilities.
Based on BullMQ queues for robust processing.
Why Use Linkzly Custom Webhooks?
Build custom workflows and automations with flexible webhook delivery and advanced security features.
Flexible Automation
Trigger actions on 13 events (e.g., link_clicked, qr_scanned) in tools like Zapier.
Security First
HMAC signing verifies payloads; HTTPS enforcement.
Reliable Delivery
Exponential/linear retries (up to 10), timeouts (1-300s).
Customization
Headers, filters, metadata for tailored payloads.
Scalability
Burst limits, circuit breakers prevent overloads.
No-Code Power
Easy for non-devs; advanced for pros.
Key Features in Linkzly's Custom Webhooks
Comprehensive webhook functionality with advanced filtering, security, and monitoring.
Events
All 13 types with filters (conditions, exclude properties).
Signing
SHA256 with timestamp, secret rotation.
Retries
Policies (exponential, etc.), max 10 attempts.
Rate Limiting
Per-minute/burst for control.
Analytics
Delivery stats, breakdowns, health scores.
Timeouts
1-300s; max payload 1MB.
Step-by-Step Setup Guide
Build custom flows in minutes.
Access Integrations
Linkzly > "Integrations" > Add Custom Webhook.
Enter Details
URL, events[], secret (auto-generated).
Configure Advanced
Retry policy, headers, filters, rate limits.
Map Payload
Include metadata, tags; exclude properties.
Test Connection
Send test event; verify signature.
Activate & Monitor
Enable; view deliveries, analytics.
Sample Event Payload
Signed click event:
{
"event": "link_clicked",
"data": {
"short_code": "abc123",
"referrer": "https://example.com",
"geo_country": "US"
},
"timestamp": 1627849200,
"id": "webhook123"
}Headers
X-Webhook-Signature: sha256=hex, X-Webhook-Timestamp.
Verification
hmac(timestamp.payload) == signature.
Best Practices for Production-Grade Use
Follow these recommendations to ensure optimal performance and security.
Security
Rotate secrets; validate timestamps (5min skew).
Retries
Use exponential for failures; monitor consecutive errors.
Limits
Set rate_limit_per_minute; use dead-letter queues.
Testing
Simulate failures; check circuit breakers.
Scaling
Namespace queues; use metadata for tagging.
Real-World Example: CRM Sync
Webhook to Zapier updates CRM on "link_clicked." Automates leads from scans, boosting efficiency 40%.
Customize now in Linkzly—automate your success!
Popular Integration Examples
Common use cases for custom webhook automations.
Zapier Integration
Trigger Zapier workflows on link clicks to update CRM, send emails, or create tasks automatically.
Make (Integromat)
Create complex automation scenarios with Make to process webhook data through multiple services.
Custom Scripts
Send events to your own servers for custom processing, analytics, or business logic execution.