Skip to main content
Here is how to set it up:

Prerequisites

In Lago:
  1. Create a Lago organization to manage your billing and invoicing;
  2. Create a Billable metric to track the usage of your customers;
  3. Create a Plan and price the above billable metric to determine the billing rates for your customers; and
  4. Create a Customer and assign the Plan.
In Hightouch:
  1. Create a Hightouch account;
  2. Create a data source (ideally, product usage of your customer);
  3. Create an HTTP Request destination.

Send usage from Hightouch to Lago

Create a data source

First, create a source in Hightouch:
  1. Navigate to the Sources tab;
  2. Add a new source; and
  3. Choose and set up a data source that is available in Hightouch (it could be a database, a warehouse or a spreadsheet, for instance).

Hightouch Sources

Use the HTTP Request destination

Lago uses Hightouch’s HTTP Request to ingest usage. Here is how to set it up:
  1. Go to the Destinations tab;
  2. Select the HTTP Request destination;
  3. Define your Headers. Lago requires Authorization (secret, used for the API Key) and Content-Type: application/json headers; and
  4. Save this newly created destination.

Hightouch HTTP Request Destination

Create a Sync

To send usage from Hightouch to Lago, go to the Syncs tab and create a new sync from your source to this HTTP Request destination.
  1. Configure when you want to trigger the event (row added, row deleted, row updated);
  2. Define POST as the targeted HTTP Method;
  3. Define the targeted url (for usage events, use https://api.getlago.com/api/v1/events);
  4. Send data as JSON and use the JSON editor;
  5. Define rate limits, if applicable

Example of JSON payload

You define the JSON payload sent to Lago yourself. Note that Hightouch supports Liquid template language to insert variables from your source to your JSON payload. These variables are created following this syntax: "{{ row.variable }}", “variable” being the column name of your source. Here is a JSON payload example to send usage events to Lago:
The body structure of the event depends on your use case. Please adapt it if needed (ie: remove or add properties).

Test and activate your sync

Note that you can test your sync with a data sample. As a result of this test, you should see data flowing into Lago, in the events list. Once you are ready to go, you can activate this sync, and define the periodic trigger.

Hightouch Test Sync with Lago

Hightouch to Lago demo video

This video walks through the full setup for sending events from Hightouch to Lago.