Configuring Webhooks

Developers can follow the below guide to learn how to listen to webhooks:

1. Open Webhook Settings
   Go to the Coinflow Admin Dashboard → Developers → Webhooks

2. Add a new Webhook URL

   

3. Generate a Webhook Validation Key

   

4. Configure Webhook Settings
   Select Latest Webhook Version > Select all events to listen to > Save.

   

5. Add an Endpoint on Your Server
   Create a POST route to receive events from Coinflow.

   router.post('/coinflow-webhook', async (req, res) => {
     try {
       const { data } = req.body;
       const authHeader = req.get('Authorization'); //Ensure the Authorization matches your Validation Key to validate that this request is coming from Coinflow
       if (authHeader !== process.env.COINFLOW_VALIDATION_KEY) {
         throw new ControllerError('User not allowed', 401);
       }
       console.log(`Event: ${data}`);
       handleEvent(); // Add your custom logic here
       res.sendStatus(200);
     } catch (e) {
       handleError(res, e);
     }
   });

ℹ️ Coinflow will retry sending webhook events until:

• Your server returns a 200 OK
• Or 36 hours passes
• Note: Your server must respond within 5 seconds or the request will timeout and retry.