How to add a webhook to a Conversation API app

Sinch Conversation API delivers contact messages, delivery receipts for app messages and various notifications through callbacks. You can create up-to 5 endpoints (webhooks) per conversation API app through the Sinch Build Dashboard or by using the /webhooks management endpoint.

To add a new webhook to your Conversation API app:

1. Log in to the Sinch Build Dashboard.
    
2. Select Conversation API from the left menu and select the Apps option. The Conversation Apps page is displayed.
    

3. Click the name of the app to which you want to add the webhook. For example, click TestApp. The TestApp setup page is displayed. Scroll down to the Webhooks section:
   
   

   Note: If you do not already have a Conversation API App – click here to learn how to create one.
    

4. Click ADD WEBHOOK. The New webhook dialog box is displayed:
   
   
    
5. In the Target type drop-down, select HTTP.
    
6. In the Target URL field, enter the URL to which you want the webhook to point.
    
7. If you want the webhook to validate against your chosen endpoint using HMAC, enter the token you want the webhook to use in the Secret token field.
   
   
    
8. Select all the triggers you want to add to the webhook, in the Triggers down-down:
   
   
   
   For more information about the kinds of information and events the triggers can return, see the webhook triggers documentation.
    
9. To configure OAuth2.0 authentication, click the button under Enable OAuth2 authentication. Populate the Client ID, Client secret, and Token endpoint fields with the credentials Sinch will use to authenticate against the OAuth token-provision endpoint.
   
   
    
10. Click Create to add the webhook.
    
    
     
11. The webhook is created and is displayed in the Webhooks section of the app page.