Webhooks

No Code

Overview

The Deel Developer Center provides a user-friendly interface for managing your webhook subscriptions without writing code. You can create, view, edit, test, and delete webhooks all from your browser.

  • Visual Management: Create and manage webhooks through an intuitive UI
  • Real-Time Logs: View webhook delivery logs and troubleshoot issues
  • Easy Testing: Test webhooks and see payloads before going live
  • Instant Updates: Update URLs and events without redeploying code

Accessing the Developer Center

1

Log in to Deel

Go to app.deel.com and log in with your account

3

Go to Webhooks tab

In the Developer Center, click on the Webhooks tab to view all your webhook subscriptions

Sandbox vs Production: Make sure you’re in the correct environment. Webhooks created in sandbox only work with sandbox events.

Creating a Webhook

Create a new webhook subscription directly from the Developer Center:

1

Click 'Create Webhook'

In the Webhooks tab, click the Create Webhook button in the top right

2

Enter webhook details

Fill in the webhook form:

  • Webhook URL: Your HTTPS endpoint that will receive events
  • Description: A friendly name to identify this webhook (e.g., “Production Slack notifications”)
  • Events: Select which events you want to receive
3

Save and get your signing key

Click Create and you’ll receive:

  • A unique webhook ID
  • A signing key for verifying webhook signatures

Save your signing key immediately! You won’t be able to see it again. Store it securely as an environment variable.

Start small: Subscribe to just one or two event types initially. You can always add more events later once you’ve tested your integration.

Viewing Webhooks

The Webhooks dashboard shows all your active subscriptions:

Webhook List

Each webhook displays:

  • URL: Where events are being sent
  • Description: Your custom identifier
  • Status: Active, Disabled, or Error
  • Events: Number of subscribed event types
  • Created: When the webhook was created

Webhook Details

Click on any webhook to see:

  • Full list of subscribed events
  • Delivery statistics (success rate, failures)
  • Recent delivery attempts
  • Webhook configuration

Viewing Webhook Logs

Monitor webhook deliveries in real-time:

1

Open webhook details

Click on a webhook from your list to open its detail page

2

Go to Logs tab

Click the Logs tab to see recent webhook deliveries

3

Inspect delivery attempts

For each delivery, you can see:

  • Timestamp: When the webhook was sent
  • Event Type: What triggered the webhook
  • Status: Success (2xx) or Failed (4xx/5xx)
  • Response Code: HTTP status code from your endpoint
  • Response Time: How long your endpoint took to respond
4

View full payload

Click on any log entry to see:

  • Complete request payload (headers and body)
  • Your endpoint’s response
  • Retry attempts (if applicable)

Status meanings:

  • ✅ Success (200-299): Your endpoint processed the webhook successfully
  • ⚠️ Retry Pending: Temporary failure, will retry automatically
  • ❌ Failed (400-499): Client error, check your endpoint code
  • ❌ Failed (500-599): Server error, check your server health
  • ⏱️ Timeout: Your endpoint didn’t respond within 30 seconds

Editing Webhooks

Update an existing webhook subscription:

1

Select the webhook

Click on the webhook you want to edit from your list

2

Click 'Edit'

Click the Edit button in the top right of the webhook details page

3

Modify settings

You can update:

  • Webhook URL (useful when deploying to a new server)
  • Description
  • Subscribed events (add or remove event types)
4

Save changes

Click Save to apply your changes. They take effect immediately.

Changing the URL: If you update the webhook URL, make sure your new endpoint is ready to receive webhooks before saving. Any events that occur during the transition will be sent to the new URL.

Testing Webhooks

Test your webhook before going live:

1

Open webhook details

Navigate to the webhook you want to test

2

Click 'Send Test Event'

Click the Send Test Event button

3

Select event type

Choose which event type to simulate (e.g., contract.created)

4

Review test payload

The Developer Center will show you the exact payload that will be sent. You can:

  • Review the JSON structure
  • Modify test data if needed
5

Send test

Click Send Test to deliver the webhook to your endpoint

6

Check results

View the response immediately:

  • HTTP status code
  • Response time
  • Response body
  • Any errors

Use test webhooks liberally! They don’t affect production data and help you debug issues before real events trigger your endpoint.

Disabling Webhooks

Temporarily stop a webhook without deleting it:

1

Open webhook details

Click on the webhook you want to disable

2

Click 'Disable'

Click the Disable button in the top right

3

Confirm

Confirm you want to disable the webhook

What happens when disabled:

  • No new events will be sent to your endpoint
  • Pending retries are cancelled
  • The webhook configuration is preserved
  • You can re-enable it anytime by clicking Enable

Automatic disabling: Webhooks are automatically disabled after 10 consecutive failed delivery attempts. You’ll receive an email notification when this happens.

Deleting Webhooks

Permanently remove a webhook subscription:

1

Open webhook details

Click on the webhook you want to delete

2

Click 'Delete'

Click the Delete button in the top right

3

Confirm deletion

Type the webhook URL to confirm deletion (this prevents accidental deletions)

This action cannot be undone! Once deleted:

  • The webhook configuration is permanently removed
  • The signing key becomes invalid
  • All delivery logs are deleted
  • You’ll need to create a new webhook subscription if you want to re-enable it

Troubleshooting

Possible causes:

  • 10 consecutive failed deliveries
  • Manually disabled
  • Endpoint URL no longer valid

How to fix:

  1. Check webhook logs to see why deliveries failed
  2. Fix your endpoint (verify it’s accessible, returns 200, etc.)
  3. Click Enable to reactivate the webhook

Common issues:

  • Endpoint returning non-2xx status codes
  • Timeout (endpoint taking longer than 30 seconds)
  • SSL certificate errors
  • Signature verification failing

How to debug:

  1. Click on a failed log entry to see the error details
  2. Check your endpoint logs for errors
  3. Use the “Send Test Event” feature to reproduce the issue
  4. Verify your signature verification code is correct

Check:

  • Is the webhook enabled?
  • Are you subscribed to the correct event types?
  • Are you in the right environment (sandbox vs production)?
  • Is the event actually occurring? (Check event logs)

How to verify:

  1. Go to webhook details and check subscribed events
  2. Send a test event to confirm your endpoint works
  3. Trigger a real action and check logs within a few seconds

Possible causes:

  • Insufficient permissions
  • Developer Center not enabled for your account

How to resolve:

  1. Contact your Deel account administrator
  2. They may need to grant you developer access
  3. Alternatively, reach out to Deel Support

Best Practices

Name webhooks clearly (e.g., “Prod: Contract Events → Slack” instead of “webhook-1”)

Check webhook logs weekly to catch issues before they become critical

Always test webhooks in sandbox before creating production subscriptions

Update webhook URLs promptly when deploying to new servers

Begin with a few event types and add more as needed

Keep track of which webhooks power which features in your app

Managing via API

While the Developer Center is great for visual management, you can also manage webhooks programmatically:

$curl 'https://api.letsdeel.com/rest/v2/webhooks' \
>  -H 'Authorization: Bearer YOUR_API_TOKEN'

When to use API vs Developer Center:

  • Developer Center: Quick setup, testing, troubleshooting, viewing logs
  • API: Automation, CI/CD pipelines, programmatic management, bulk operations

Additional Resources

Webhooks Quickstart

Set up your first webhook endpoint

Event Types

Browse all available webhook events