Programmatic testing of TwiML Bins

If you want to programmatically test your TwiML Bins, you'll have to generate a valid X-Twilio-Signature using your Account SID and Auth Token, and then make an HTTP request to your TwiML Bin URL that contains:

The X-Twilio-Signature HTTP header
The AccountSid either as a query parameter or POST body parameter

Generating the X-Twilio-Signature

Some of our helper libraries provide you with the ability to generate an X-Twilio-Signature to verify that a webhook request comes from your Twilio account. You can use the same tooling to generate a valid X-Twilio-Signature. For example, in Node.js this would look like:

1const webhooks = require('twilio/lib/webhooks/webhooks');
2const eventData = {
3  AccountSid: accountSid,
4}
5const signature = webhooks.getExpectedTwilioSignature(
6  authToken,
7  url,
8  eventData
9);

Using this data, you can then make your HTTP request successfully, as long as you pass an X-Twilio-Signature HTTP header and the same data in the POST body that you passed to the eventData object of the getExpectedTwilioSignature() function.

Example

Here's a full example in Node.js that makes an HTTP request using Axios to a TwiML Bin URL, and compares the result against the expected result.

1const webhooks = require('twilio/lib/webhooks/webhooks');
2const { default: axios } = require('axios');
3const assert = require('assert');
4
5async function makeTwiMLBinRequest(url, data) {
6  // Get account credentials from your environment variables
7  const accountSid = process.env.TWILIO_ACCOUNT_SID;
8  const authToken = process.env.TWILIO_AUTH_TOKEN;
9
10  const eventData = {
11    AccountSid: accountSid,
12    ...data
13  }
14
15  // Construct a valid application/x-www-form-urlencoded POST body
16  const params = new URLSearchParams();
17  for (const [key, value] of Object.entries(eventData)) {
18    params.append(key, value);
19  }
20  data = params.toString();
21
22  // Generate the X-Twilio-Signature
23  const signature = webhooks.getExpectedTwilioSignature(
24    authToken,
25    url,
26    eventData
27  );
28  const headers = {};
29  headers['X-Twilio-Signature'] = signature;
30
31  // Make the HTTP request to the passed URL
32  const response = await axios.request({
33    method: 'POST',
34    headers,
35    url,
36    data
37  })
38  return response.data;
39}
40
41// Make an HTTP request to your TwiML Bin
42const response = await makeTwiMLBinRequest('https://handler.twilio.com/twiml/EHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa', { Body: 'Hello' })
43
44// Compare the output against your expected result
45assert.deepEqual(response, `<?xml version="1.0" encoding="UTF-8"?>
46<Response>
47  <Message>Ahoy</Message>
48</Response>`);