Skip to main content
Webhooks allow you to receive real-time HTTP notifications when events occur in your Gately project. Use them to trigger automations, sync data, or integrate with external services.

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

  1. Go to Webhooks in your dashboard
  2. Click Create Webhook
  3. Enter your endpoint URL
  4. Select events to subscribe to
  5. 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

Return a 200 response immediately, then process the event asynchronously.
Use the event id to deduplicate events (webhooks may be sent multiple times).
Always verify the webhook signature to prevent spoofing.
Only use HTTPS endpoints for security.
Log all received events for debugging and auditing.

Testing Webhooks

Test from Dashboard

  1. Go to Webhooks > [Your Webhook]
  2. Click Send Test Event
  3. Select event type
  4. View response

Local Development

Use a tunnel service like ngrok for local testing:
Then use the ngrok URL as your webhook endpoint.

Webhook Logs

View webhook delivery history:
  1. Go to Webhooks > [Your Webhook] > Logs
  2. See all delivery attempts
  3. View request/response details
  4. Retry failed deliveries