Webhooks

Send encrypted data to external systems when events happen in your workspace.

Advanced
2 min read

Webhooks

Send data to your external systems when events happen in your workspace.

Setting Up Webhooks

Webhooks are configured as Actions:

  1. Go to Actions
  2. Create a new action with trigger (e.g., "Data Record Created")
  3. Select Send Webhook as the action type
  4. Enter your HTTPS endpoint URL

Security

Encryption

All webhook payloads are encrypted using JWE (JSON Web Encryption):

  • Algorithm: A128GCM
  • Key: Auto-generated per workspace

Find your decryption key in SettingsAPI Keys.

Decrypting Payloads

python

The encrypted format:

json

Payload Examples

Data Record Created

json

Member Updated

json

Testing

  1. Use webhook.site for development
  2. Create a test action pointing to your test URL
  3. Trigger the event
  4. Verify the payload arrives and decrypts correctly

Tips

  • Always HTTPS - Webhook URLs must use HTTPS
  • Handle retries - Implement idempotent handlers
  • Check logs - Failed webhooks appear in action logs