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 UIReal-Time Logs: View webhook delivery logs and troubleshoot issuesEasy Testing: Test webhooks and see payloads before going liveInstant Updates: Update URLs and events without redeploying code
Accessing the Developer Center
2 Navigate to Developer Center Click on your profile icon in the top right, then select Settings → Developer Center
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 eventsDescription : 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 sentDescription : Your custom identifierStatus : Active, Disabled, or ErrorEvents : Number of subscribed event typesCreated : 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 sentEvent Type : What triggered the webhookStatus : Success (2xx) or Failed (4xx/5xx)Response Code : HTTP status code from your endpointResponse 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)
Understanding Webhook Status Indicators 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
Webhook shows 'Disabled' status Possible causes:
10 consecutive failed deliveries
Manually disabled
Endpoint URL no longer valid
How to fix:
Check webhook logs to see why deliveries failed
Fix your endpoint (verify it’s accessible, returns 200, etc.)
Click Enable to reactivate the webhook
High failure rate in logs Common issues:
Endpoint returning non-2xx status codes
Timeout (endpoint taking longer than 30 seconds)
SSL certificate errors
Signature verification failing
How to debug:
Click on a failed log entry to see the error details
Check your endpoint logs for errors
Use the “Send Test Event” feature to reproduce the issue
Verify your signature verification code is correct
Not receiving expected events 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:
Go to webhook details and check subscribed events
Send a test event to confirm your endpoint works
Trigger a real action and check logs within a few seconds
Can't find Developer Center Possible causes:
Insufficient permissions
Developer Center not enabled for your account
How to resolve:
Contact your Deel account administrator
They may need to grant you developer access
Alternatively, reach out to Deel Support
Best Practices
Use Descriptive Names Name webhooks clearly (e.g., “Prod: Contract Events → Slack” instead of “webhook-1”)
Monitor Regularly Check webhook logs weekly to catch issues before they become critical
Test Before Production Always test webhooks in sandbox before creating production subscriptions
Keep URLs Updated Update webhook URLs promptly when deploying to new servers
Start Small Begin with a few event types and add more as needed
Document Everything 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:
When to use API vs Developer Center:
Developer Center : Quick setup, testing, troubleshooting, viewing logsAPI : Automation, CI/CD pipelines, programmatic management, bulk operations Additional Resources
