JavaScript

Create a webhook

  1. To create a webhook, make a POST request to:

    https://api.vonage.com/t/vbc.prod/vis/v1/self/webhooks/

  2. In the body of the request, you will need to enter the following JSON:

     {
      "url": "{YOUR_URL}",
      "events": [
      "CALL"
      ],
      "signingAlgo": "HMAC_SHA256",
      "signingKey": "string",
      "metadataPolicy": "NONE"
    }
    
  3. The full curl request will look like the following:

    curl --location --request POST 'https://api.vonage.com/t/vbc.prod/vis/v1/self/webhooks/' \ --header 'Authorization: Bearer {ACCESS_TOKEN}' \ --header 'Content-Type: application/json' \ --data-raw '{ "url": "https://{NGROK_URL}/webhook", "events": [ "CALL" ], "signingAlgo": "HMAC_SHA256", "signingKey": "string", "metadataPolicy": "NONE"
  4. In the url parameter, you will need to add your accessible URL. This URL will be called by the Vonage Integration Platform API when a call has been updated. A good way to create an accessible URL is to use ngrok to expose a port on your local machine.

Next, you will create your local server. To create your local server, we will be using ExpressJS for the NodeJS application.