Integromat
  • Back to website
Articles in this section
  • Receiving a Webhook from a Web Service
  • Connecting Integromat to any Web Service
  • Connecting Integromat to a Web Service That Uses API Tokens Authorization
  • Allowing connections from Integromat
  • Keys
  • Connecting to services
  1. Integromat Support
  2. Using Integromat
  3. Connections

Connecting Integromat to a Web Service That Uses API Tokens Authorization

Integromat Support Team Integromat Support Team Updated January 16, 2021 12:12

There are some services that do not allow Integromat (and other integration platforms) to create an app that you can easily use in your scenario.
Fortunately, there is a workaround. You can connect the desired service (app) to Integromat using Integromat's HTTP module.

In the following article, we will describe how to connect almost any web service to Integromat using an API Key/API token.
Like it is for most web services, the procedure of connecting the service via an API token is similar and consists of the following steps:

  1. Create an application on the web service's website.
  2. Obtain the API Key/API token.
  3. Add Integromat's HTTP > Make a Request module to your scenario.
  4. Set up the module according to the web service's API documentation and running the scenario.

 

We will use the Pushover notification service as an example.

Creating a New Application and Obtaining the API Token

1. Log in to your Pushover account.

2. Click on the Create an Application/API Token link on the bottom of the page.

2019-11-20_11_40_10-Window.png

3. Fill in the Application Information and click the Create an Application button.

83115TLAsY.gif

4. Store the provided API token in a safe place. You will need it for your Integromat's HTTP > Make a Request module to connect to the desired web service (Pushover, in this case).

2019-11-20_11_58_49-Window.png

Setting Up the HTTP module

To connect a web service to your Integromat scenario, you need to:

  • Employ the HTTP > Make a Request module in your Integromat scenario.
  • Set up the HTTP > Make a Request module according to the web service's API documentation.

1. Add the HTTP > Make a Request module to your scenario.

2019-11-20_12_30_52-Window.png

2. To push a message using Integromat, set up the HTTP module as follows:

These module settings correspond to the Pushover web service API documentation. Settings may be different for other web services. For example, the API token may be inserted to the Header and not to the Body field.

URL
https://api.pushover.net/1/messages.json
The URL field contains the endpoint that you can find in the respective web service's API documentation.

2019-11-20_12_49_34-Window.png

Method
POST
The used method depends on the corresponding endpoint. The Pushover endpoint for pushing messages uses the POST method.

2019-11-20_12_54_38-Window.png

Headers
Some web services may use Headers to specify the API token authentication and/or other parameters. This is not the case in our example as the Pushover's endpoint for pushing messages uses Body (see below) for all request types.

Query String
Some web services may use Query String to specify other parameters. This is not the case in our example as the Pushover web service uses Body (see below) for all request types.

Body Type
Raw
This setting allows you to select the JSON content type in the Content Type field below.

Content Type
JSON (application/json)
JSON is the required content type by the Pushover app. This may differ from other web services.

Request Content
Enter the Body request content in the JSON format. You can use the JSON > Create JSON module or enter the JSON content manually.

See the web service's API documentation for the required parameters (fields).

2019-11-20_13_19_45-Window.png

JSON Body Entered Manually

Specify parameters and values in the JSON format.

Example:

{"user":"12345c2ecu1hq42ypqzhswbyam34",
"token":"123459evz8aepwtxydndydgyumbfx",
"message":"Hello World!",
"title":"The Push Notification"}
user

Your USER_KEY. Can be found in your Pushover dashboard.

2019-11-20_13_34_27-Window.png

token Your API token/API Key that was generated in step 4 when you created the Pushover app.
message The text content of the push notification that is sent to the device(s).
title Your message's title, otherwise, your app's name is used. Optional.

JSON Body Mapped Using the JSON > Create JSON module

The Create JSON module makes the specifying JSON easier. It also gives you the possibility to define values dynamically.
For more information about the JSON modules please refer to the JSON documentation.

1. Enter (or map) the values you want to create JSON from.

2019-11-20_13_55_51-Window.png

2. Connect the JSON > Create JSON module to the HTTP > Make a Request module you have already set up (above).

2019-11-20_13_57_28-Window.png

3. Map the JSON string from the Create JSON module to the Request content field in the HTTP > Make a Request module.

uElFgX7Ebx.gif

Now when you run the scenario, the push notification is sent to the device that has been registered in your Pushover account.

Was this article helpful?
15 out of 23 found this helpful
Menu
  • Features
  • Apps & Services
  • Templates
  • Pricing
  • What's new
  • Use cases
Information
  • Terms,  Privacy
  • FAQ
  • Help & Tutorials
  • Community
  • Affiliate Program
  • Blog
Developers
  • Developer Platform
Company
  • About the company
  • Join our team
  • Contact
Follow us
© 2020 Integromat by Celonis. All rights reserved. Integromat® is a registered trademark.
  • English