Overview
When an event occurs (e.g., new member signup), Gately sends an HTTP POST request to your configured webhook URL with event data.Setting Up Webhooks
Via Dashboard
- Go to Webhooks in your dashboard
- Click Create Webhook
- Enter your endpoint URL
- Select events to subscribe to
- Save
Webhook Configuration
Events
Member Events
Form Events
Subscription Events
Payment Events
Helpdesk Events
Payload Format
All webhook payloads follow this structure:Example: Member Created
Example: Form Submitted
Verifying Webhooks
All webhooks are signed with your webhook secret. Verify the signature to ensure the request is from Gately.Signature Header
Verification (Node.js)
Verification (Python)
Retry Policy
If your endpoint returns a non-2xx status code, Gately will retry:
After 5 failed attempts, the webhook is marked as failed.
Best Practices
Respond Quickly
Respond Quickly
Return a 200 response immediately, then process the event asynchronously.
Handle Duplicates
Handle Duplicates
Use the event
id to deduplicate events (webhooks may be sent multiple times).Verify Signatures
Verify Signatures
Always verify the webhook signature to prevent spoofing.
Use HTTPS
Use HTTPS
Only use HTTPS endpoints for security.
Log Events
Log Events
Log all received events for debugging and auditing.
Testing Webhooks
Test from Dashboard
- Go to Webhooks > [Your Webhook]
- Click Send Test Event
- Select event type
- View response
Local Development
Use a tunnel service like ngrok for local testing:Webhook Logs
View webhook delivery history:- Go to Webhooks > [Your Webhook] > Logs
- See all delivery attempts
- View request/response details
- Retry failed deliveries