Skip to main content

​
Webhooks Introduction

Webhooks enable your application to receive instant notifications about important events, making it easy to automate workflows and keep external systems in sync with Carbon’s API.

​
What Are Webhooks?

Webhooks are HTTP callbacks triggered by specific events in your Carbon account. When an event occurs, Carbon sends a POST request to your configured webhook URL, allowing your server to process the event in real time.

​
How Webhooks Work

1

Configure Your Webhook URL

Set your webhook endpoint using the API or dashboard. Make sure your server is ready to accept POST requests.
2

Event Triggered

When a relevant event occurs (e.g., a transaction is completed), Carbon automatically sends a POST request to your webhook URL with event details.
3

Acknowledge Receipt

Your server should respond with a 2xx status code to confirm successful receipt. If not, Carbon may retry delivery.

​
Key Features

Receive immediate updates for events such as transactions, account changes, and more.
Easily update your webhook URL or select which events you want to subscribe to.
Each webhook request includes a signature secret for verification. Always validate the signature to ensure authenticity.

​
Example Webhook Events

Some common events you can subscribe to:
  • account.incoming-transaction
  • account.outgoing-transaction
For a full list and details, see the Webhook Events documentation.

​
Best Practices

Always verify the signature included in webhook requests to confirm they originate from Carbon.
If your server does not respond with a 2xx status code, Carbon will retry delivery. Ensure your endpoint can handle duplicate events safely.
Set up logging and monitoring for your webhook endpoint to track received events and troubleshoot issues quickly.

​
Troubleshooting & Support

If you experience issues with webhook delivery or event processing, check your server logs and ensure your endpoint is publicly accessible. For further assistance, refer to the Error Handling documentation or contact Carbon support.