Help

HTTP

Supported Actions

HTTP

HTTP(S) request and response processing

Sends a HTTP(S) request to a specified URL and processes the response.

HTTP

OAuth 2.0 HTTP(S) request and response processing

Sends a HTTP(S) request to a specified URL requiring OAuth 2.0 autorization and processes the response.

Getting started with the HTTP package

The HTTP package allows you to process HTTP(S) requests and responses exchanged with any website. The HTTP package is perfectly suited for monitoring events occurred on a specific website, such as website failures and the like. All you have to do is to enter the URL you want to monitor (you may also change the request method to be used, specify the request content or determine HTTP headers).

OAuth 2.0 Requests

The HTTP package lets you, among other things, make HTTP(S)request to servers that require OAuth 2.0 authorization. To be able to make a request, you first need to create an OAuth connection.

Creating a connection

  1. Create an OAuth client in the target service with which you want Integromat to communicate. This option can be mostly found in the Developer section of the given service. When creating the client, you will be asked to specify a so called Redirect URL (sometimes called as Callback URL). You always enter https://www.integromat.com/oauth/cb/oauth2 in this field.

    Once you have created the client, the given service will display two keys Client ID and Client Secret. Some services call these App Key and App Secret. Make sure you write down these keys, you will be asked to provide them when creating the connection in Integromat.

  2. Check the API documentation for the given service to find out the Authorize URI and Token URI. These are URL addresses through which Integromat communicates with the target service. The addresses serve for OAuth authorization.

    Examples of Yahoo addresses:

    • Authorize URI: https://api.login.yahoo.com/oauth2/request_auth
    • Token URI: https://api.login.yahoo.com/oauth2/get_token
  3. Check the documentation for the target service to find out if the Access token needs to be renewed with Refresh token. If yes, enable the Validate Access token with Refresh Token option when creating the connection in Integromat.

  4. If the target service uses so called scopes (access rights), check how the service separates individual scopes and make sure you set the separator in the advanced settings accordingly. If the separator is not set correctly, Integromat will fail to create the connection and you will receive an invalid scope error.

  5. Once you have completed the steps above, you can start to create the OAuth connection in Integromat. Add the "OAuth 2.0 HTTP(S) request and response processing" module to your scenario and in the "Connection" section click on the "Add" button.

Advanced information

Standard authorization parameters

  • response_type: code
  • redirect_uri: https://www.integromat.com/oauth/cb/oauth2
  • client_id: Client ID you entered when creating the account

Requesting Access tokens - standard parameters

  • grant_type: authorization_code
  • redirect_uri: https://www.integromat.com/oauth/cb/oauth2
  • client_id: Client ID you entered when creating the account
  • client_secret: Client Secret you entered when creating the account
  • code: The code returned by authorization request

Requesting Refresh tokens - standard parameters

  • grant_type: refresh_token
  • refresh_token: Refresh token obtained together with Access token
  • client_id: Client ID you entered when creating the account
  • client_secret: Client Secret you entered when creating the account

Authorized request made to a service

After the connection is established, the module uses Bearer token which is sent in the request header field. The bearer token has the following format: Authorization: Bearer <access token>

Rate this article: