Skip to main content
waffle.svg
Domo Knowledge Base

JSON Webhook Connector

Intro

Domo's JSON Webhook connector allows you to connect to data sources that push JSON-formatted data, such as IFTTT, Github,and FItbit. Using JSON Webhooks, you can get access to real-time data from weather devices, vending machines, wearables, and more. The Webhook link includes a long-living single use token so anyone with the link can publish data to your DataSet. 

You set up your JSON Webhook connection by configuring options in the Data Center as well as in the third-party application, as described in continuation.

Setting up a JSON Webhook Connection

This section explains how to set up a JSON Webhook connection in Domo and in the third-party application. Once you have set up a successful connection, you can use the same account any time you go to create a new JSON Webhook DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.

To set up a JSON Webhook connection,

  1. Select new_app_icon.png > Appstore. 

  2. Click the Connectors tab. 

  3. Search for "JSON Webhook," then click the tile when it appears.

  4. Click Get the Data.

  5. Click Copy Link.

  6. Paste the link you just copied into the appropriate location in your third-party application.

    json_webhook_3rd_party_url.png

    This location will usually be a field with a name like "Payload URL," like in the above screenshot. However, there are exceptions. Please refer to the third-party application's documentation if you are not sure. 

    Also, be sure to follow the third-party application's requirements for pasting the URL. In some applications, the token (the piece after the last backslash) must be pasted on a different line.

  7. Also in the third-party application, be sure to set the content type to "application/json."

    json_webhook_3rd_party_content_type.png

  8. Configure other settings in the third-party application as necessary then save the webhook.

  9. Return to the JSON Webhook connector interface in Domo.

  10. (Optional) Enter a Webhook Secret if desired. 
    Secrets are only supported if using sha1 in the X-Hub-Signature header. The header will have a value like 'sha1={sha1 has of my payload, using my secret}'.

  11. (Optional) If you want to include metadata in the DataSet, such as IP and timestamp, select Yes in the last menu in the Details view; otherwise leave this set to No.

  12. (Optional) If you want to use "Replace" instead of "Append" when the DataSet is updated, click Change update settings, select Replace in the menu, then click Save.

  13. Click Next.

  14. Enter a DataSet name and description (optional) in the correct fields. 

  15. Click Save.

You should now have a functional connector that collects data from the third-party application every 15 minutes. 

FAQs

What type of data do I need to push to this connector?

JSON-formatted data.

What does it mean if my data includes blank fields?

Because the connector creates a record for each row, if a row does not include data, that row will appear blank in your DataSet.

Who can push data into my Webhook DataSet?

The Webhook link includes a long-living single use token, so anyone with the link can publish data to your DataSet.

Can anyone with the Webhook link see the data in my DataSet?

The Webhook link will push the data but will not show or expose any data.

What is the rate limit for this connector?

25 calls per second.