How to Connect to HTTP Request as an External Data Source

Like other external data sources, HTTP request allows you to automate the creation of message content. This request uploads and sends contact data from eSputnik to other systems, and vice versa, transfers data from third-party systems to eSputnik. With its help, you can refer to your API, which will process the request and return personalization data to the message, for example, a personal promo code. The Velocity language is used to transfer data.

Instructions for Connecting HTTP Request

1. In your account settings, open the Data Sources tab, click on the New data source button and select External data source.

Account settings

2. In the pop-up window, select HTTP request.

HTTP request

3. Set up the connection:

1) Give an arbitrary name to the data source.

2) Add a description if necessary.

3) Select the type of request: GET or POST.

4) Enter the URL to be requested (HTTPS only). You can refer to contact fields and event parameters.


5) If your application reads parameters from headers, activate the corresponding switcher. Then specify the required parameters and their values.

Passing parameters in headers

6) To configure authentication, activate the corresponding switcher. There are three types of authentication available:

  • Basic,
  • Bearer token,
  • API key (in headers or the query string).

Specify the connector name. Select the authentication type. Enter your credentials (login and password/token/key). Click on the Done button.

Authentication settings

7) If your application reads parameters from the request body, activate the corresponding switcher, enter the request body in the text area and specify the format: JSON, XML or text.

Passing parameters in the request body

4. Test the connection. To do this, you can select an event from history or manually paste the request body for testing.

Passing parameters in the request body

More on adding data to a message>>

Any Questions?
We’re always happy to help!
Request a Callback
Fill in the form, and our specialists will call you back as soon as possible.
Request a Callback
Chat Support
We’re waiting for your questions!
Send a Chat Message
Contact the eSputnik support team
Send an Email