Burner + Webhooks =
a multipurpose Developer Connection for advanced integrations

The Developer Connection allows developers and advanced tech-savvy users to connect Burner phone numbers to other apps and systems for advanced automation and additional functionality that Burner's smart phone number platform does not already include.

Here are two examples of how you would use webhooks for integrations in the wild, using Zapier and IFTTT.

Using Webhooks with Zapier
Using Webhooks with IFTTT

How to Use Burner's Webhooks with Zapier

  1. Sign up or Log in to Zapier.
     
  2. Click the "Make a Zap" button at the top of your Dashboard.
     
  3. In the box under "Choose a Trigger App", type "webhook" and select "Webhooks by Zapier" as your Trigger.
     
  4. You should see an input box and then two options under "Select Webhooks by Zapier Trigger": "Retrieve Poll" and "Catch Hook". Select "Catch Hook" and then click the "Save + Continue" button.
  5. The next screen you should see is "Set up Webhooks by Zapier Hook." This is optional, and allows you to only look at specific information sent in by Burner. For example, if you only cared about the incoming phone numbers, you'd input "fromNumber". When you're finished, press the "Continue" button.

  6. You should now see "Test Webhooks by Zapier" at the top of this screen and a URL at the bottom. The URL will look like this: https://zapier.com/hooks/catch/111111/abcdef/. Input that URL into the "Outgoing Webhook URL" field in the Burner Developer Connection section.

  7. Click "Send test request".

  8. In Zapier, click "Ok, I did this".

  9. Note: Zapier will say "Looking for the hook, this might take a sec...", and it may take several minutes to recognize the test request.

  10. Click the "Continue" button.

  11. Under "Choose an Action App", start typing in the name of the app you'd like to connect (for this example, we'll choose Gmail).

  12. Under "Select Gmail Action", select "Send Email" (or whatever app and action you are using) and click the "Save + Continue" button.

  13. Click the "Connect a New Account" button if your app requires authentication, go through the authentication process, and then click  the "Save + Continue" button.
  14. In our Gmail example, I would choose an Address to send the email to, a Subject line, and enter something in the Body.

  15. In all the fields, you should see an icon with a plus sign. If you click this, it will show you options to insert data sent over from Burner. I will choose the Type, From Number, and Payload options to show if it's a text or phone call, who it came from, and what it contains.

  16. Click the "Continue" button.

  17. Click the "Create + Continue" button to test it, or click the "Skip Test & Continue" button.

  18. Under "Ready to turn on your Zap?" click the toggle button to turn on your Zap.

We also now have an official Burner integration for Zapier! Learn how to use Burner + Zapier.


How to Use Burner's Webhooks with IFTTT

  1. Sign up or log into your account on IFTTT.

  2. Start creating a new MAKER url by going here and clicking "Connect".

  3. You will see a URL that looks like: https://maker.ifttt.com/use/{your-key}. You'll need the key for a later step, so please make note of it.

  4. Choose a trigger by tapping the "This" button. Then search for the Maker channel.

  5. Click the "Receive a Web Request" button.

  6. Write a trigger event. For example, if you were connecting smart lights, we could write "lights" here.

  7. Click on the big "That" button and search for an action. In our example we searched for the Philips Hue action, but there are many others you could use. Click the service you want.

  8. Choose the action you want to perform when something happens on your Burner. There will most likely be a few options here. We chose "Turn On Lights."

  9. Follow any additional steps to setup your action, including any authentication.

  10. Once the action has been created, put this URL into the Outgoing Webhook field in Developer Connection:
    https://maker.ifttt.com/trigger/{trigger_name}/with/key/{your-key}
    For example, if our trigger was "lights" and our key is "123abc" it would be:
    https://maker.ifttt.com/trigger/lights/with/key/123abc

  11. Tap the "Send Test Request" button or send the Burner a text and watch whatever action you created get triggered.

  12. If you want to do advanced processing of incoming data, IFTTT allows for 3 JSON inputs: value1, value2, and value3. We mapped our payload as such:
    value1: type of message (inboundText, inboundMedia or voiceMail)
    value2: the message text, URL of the media, or URL of the voicemail
    value3: the inbound phone number

If you build something cool, post it on social media and mention us or use the hashtag #builtonburner.

If you want more advanced functionality or to build your own app with an API, check out the Burner API.

You may also send your feedback and questions to support@burnerapp.com.