Use the Make request action to make a custom request to an HTTP endpoint. You can control the request method and its contents, how it is authenticated and processed, and how it should respond to scenarios like expired certificates or redirects. If you need to add Datadog IP address ranges to your allowlist so that the HTTP action works as expected, use the IPs listed in the webhooks object. See the IP Ranges API for details.

To add an HTTP request:

1. In your app, under Queries, click + (plus) and search for HTTP.
2. Select the Make request action to add it to your app.

Specify the request method and any necessary authentication. Read the sections below for further information about the available configuration options.

Authentication

If you need to authenticate your request, use the action’s Connection to configure the authentication method. You can either select a preconfigured connection from the dropdown, or create a connection.

Create an AWS connection

1. In the Connection section, click the plus icon (+).
2. Select AWS.
3. Enter a Connection Name, Account ID, and AWS Role Name.
4. Click Create.

Create an Azure connection

1. In the Connection section, click the plus icon (+).
2. Select Azure.
3. Enter a Connection Name, Tenant ID, Client ID, and Client Secret.
4. Optionally, enter the Custom Scope to be requested from Microsoft when acquiring an OAuth 2 access token. A resource’s scope is constructed using the identifier URI for the resource and .default, separated by a forward slash (/). For example, {identifierURI}/.default. For more information, see the Microsoft documentation on .default scope.
5. Click Create.

Create an HTTP token authentication connection

The Token Auth connection uses a bearer token to authenticate the HTTP request.

1. In the Connection section, click the plus icon (+).
2. Select HTTP.
3. Enter a Connection Name.
4. Enter the Base URL for authentication.
5. For Type, ensure that Datadog is selected.
6. From the Authentication Type dropdown, select Token Auth.
7. Enter a Token Name and Token Value. You can enter multiple tokens. To reference your token in a header, parameter, or the request body, use the syntax {{ secretTokenName }}.
8. Optionally, add additional Request Headers, URL parameters and a Body to your request.
9. Click Create.

Create an HTTP basic authentication connection

The Basic Auth connection uses an authorization header with a username and password to authenticate the HTTP request.

1. In the Connection section, click the plus icon (+).
2. Select HTTP.
3. Enter a Connection Name.
4. Enter the Base URL for authentication.
5. For Type, ensure that Datadog is selected.
6. From the Authentication Type dropdown, select Basic Auth.
7. Enter a Username and Password. The required authorization request header is automatically populated using your username and password.
8. Click Create.

Create a 2 Step HTTP authentication connection

The HTTP 2 step connection allows you to make a preliminary request to retrieve an access token with which to authenticate the HTTP request. This is useful for authenticating JSON Web Token (JWT) and OAuth applications.

1. In the Connection section, click the plus icon (+).
2. Select HTTP.
3. Enter a Connection Name.
4. Enter the Base URL for authentication.
5. For Type, ensure that Datadog is selected.
6. From the Authentication Type dropdown, select 2 Step Auth.

Create an HTTP mTLS connection

The Mutual TLS (mTLS) Auth connection allows you to use a private key and TLS certificate to authenticate the HTTP request.

1. In the Connection section, click the plus icon (+).
2. Select HTTP.
3. Enter a Connection Name.
4. Enter the Base URL for authentication.
5. For Type, ensure that Datadog is selected.
6. From the Authentication Type dropdown, select mTLS Auth.
7. Click Upload File to upload your Private Key.
8. Click Upload File to upload your Certificate.
9. Click Create.

Inputs

A URL and request method are required for your request. Optionally, you can enter:

• URL parameters
• headers
• the content type
• a request body
• cookies

You can also select whether you want to allow expired certificates, or follow redirects.

Response options

Under Error on Status, enter a comma-delineated list of any status codes on which to return an error. Use the Response Parsing dropdown to override the default response parsing method inferred from the headers, and Response Encoding if the target server specifies the wrong encoding in its response headers.

Private actions

You can use a private HTTP action to interact with services hosted on your private network without exposing your services to the public internet. Private actions make use of a private action runner, which you install on a host in your network using Docker and pair with a Datadog Connection. For more information, see Private Actions.

To configure a private HTTP request:

1. Add an HTTP query to your app.

2. In the Connection section, click the plus icon (+).

3. Select HTTP.

4. Enter a Connection Name.

5. Enter the Base URL for the host in your private network.

6. For Type, ensure that Private Action Runner is selected.

7. From the Private Action Runner drop-down, select your private action runner.

8. From the Authentication Type dropdown, select an Authentication type and fill in the required fields. Private HTTP requests support the following authentication types:

   • No authentication
   • Basic authentication
   • Token authentication

   For information on configuring credentials for Token authentication, see Handling Private Action Credentials.

9. Click Next, Confirm Access and configure access to the query.

10. Click Create.

Further reading

Additional helpful documentation, links, and articles:

Find out more about connection credentials for App BuilderDOCUMENTATION

Do you have questions or feedback? Join the #app-builder channel on the Datadog Community Slack.