Hightouch

Hightouch is a customer data platform that enables businesses to sync data from their data warehouse to marketing, sales, and customer success tools, providing reverse ETL capabilities and data activation solutions to ensure consistent, real-time customer experiences across all touchpoints.

Power end-to-end data operations for your Hightouch API with Nexla. Our bi-directional Hightouch connector is purpose-built for Hightouch, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Hightouch or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Hightouch workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

• Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
• Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
• API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
• Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

Before creating a Hightouch credential, you need to obtain a Bearer Token from your Hightouch account. The Bearer Token is required to authenticate with the Hightouch API.

To obtain your Bearer Token, you need to have a Hightouch account. Once you have access to your account, you can view and manage your API tokens in your Hightouch account settings. The Bearer Token is sent in the Authorization header with the Bearer prefix (e.g., Bearer {token}) for all API requests to the Hightouch API. For detailed information about Bearer Token setup and authentication, refer to the Hightouch API documentation.

Authenticate

Credentials required

Field	Required	Secret	Description
Bearer Token	Yes	Yes

Create a credential in Nexla

1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Hightouch

2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

3. Enter your Hightouch Bearer Token in the Bearer Token field. This is the Bearer Token you obtained from your Hightouch account settings. The Bearer Token is sent in the Authorization header with the Bearer prefix for all API requests to the Hightouch API.

   Keep your Bearer Token secure and do not share it publicly. The Bearer Token provides access to your Hightouch account data and should be treated as sensitive information. You can view and manage API tokens in your Hightouch account settings. The Bearer Token is sent in the Authorization header with the Bearer prefix for all API requests to the Hightouch API. For detailed information about obtaining and managing Bearer Tokens, see the Hightouch API documentation.

4. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Hightouch connector tile, then select the credential that will be used to connect to the Hightouch account, and click Next; or, create a new Hightouch credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Hightouch endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

Fetch Sources

List all the sources in the current workspace

• This endpoint automatically retrieves all sources in your Hightouch workspace. No additional configuration is required beyond selecting this endpoint template.
• The endpoint uses GET requests to https://api.hightouch.com/api/v1/sources. The endpoint URL is automatically constructed based on the Hightouch API base URL.
• The endpoint uses incrementing offset pagination (iteration.type: paging.incrementing.offset) starting from offset 0. The response data path is $.data[*], which extracts all items from the data array in the API response.
• The endpoint expects 100 rows per page by default and automatically fetches additional pages by incrementing the offset until all sources have been retrieved.

This endpoint retrieves all sources in your Hightouch workspace. Sources represent data sources that are connected to your Hightouch account, such as databases, data warehouses, or other data systems. The endpoint supports pagination through incrementing offset, which allows you to retrieve large lists of sources efficiently. The response includes pagination metadata that indicates the current offset and total records available. For detailed information about the API response format and available fields, see the Hightouch API documentation.

List Models

List all the models in the current workspace including parent and related models

• This endpoint automatically retrieves all models in your Hightouch workspace, including parent and related models. No additional configuration is required beyond selecting this endpoint template.
• The endpoint uses GET requests to https://api.hightouch.com/api/v1/models. The endpoint URL is automatically constructed based on the Hightouch API base URL.
• The endpoint uses incrementing offset pagination (iteration.type: paging.incrementing.offset) starting from offset 0. The response data path is $.data[*], which extracts all items from the data array in the API response.
• The endpoint expects 100 rows per page by default and automatically fetches additional pages by incrementing the offset until all models have been retrieved.

This endpoint retrieves all models in your Hightouch workspace, including parent and related models. Models represent data models that define how data is structured and transformed in your Hightouch account. The endpoint supports pagination through incrementing offset, which allows you to retrieve large lists of models efficiently. The response includes pagination metadata that indicates the current offset and total records available. For detailed information about the API response format and available fields, see the Hightouch API documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

Hightouch data sources can also be manually configured to ingest data from any valid Hightouch API endpoint. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Hightouch API endpoints typically follow the pattern https://api.hightouch.com/api/v1/{endpoint_path} and return JSON. The endpoint requires Bearer Token authentication via the Authorization: Bearer {token} header, which is handled automatically by your credential configuration. For detailed information about Hightouch API endpoints and available APIs, see the Hightouch API documentation.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Hightouch data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.

Use as a destination

Click the + icon on the Nexset that will be sent to the Hightouch destination, and select the Send to Destination option from the menu. Select the Hightouch connector from the list of available destination connectors, then select the credential that will be used to connect to the Hightouch organization, and click Next; or, create a new Hightouch credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common Hightouch endpoints. Select the endpoint to which data will be sent from the Endpoint pulldown menu. Then, click on the template in the list below to expand it, and follow the instructions to configure additional endpoint settings.

Create Source

Create a new source in your Hightouch workspace.

• This endpoint automatically creates a new source in your Hightouch workspace using data from your Nexset. No additional configuration is required beyond selecting this endpoint template.
• The endpoint uses POST requests to https://api.hightouch.com/api/v1/sources. The endpoint URL is automatically constructed based on the Hightouch API base URL.
• The endpoint sends data from your Nexset as the request body in JSON format. The request body is automatically formatted according to the schema fields and data mapping you configure. Each record in your Nexset will be sent as a JSON object containing the source data to create.
• Batch mode is disabled by default for this endpoint. Each record in your Nexset will be sent as a separate API request to create a source. If you need to create multiple sources, you can send multiple records, but each will be processed as a separate request.
• This endpoint does not automatically create a data source to track the responses received from the Hightouch API after each call.

The request body must be properly formatted JSON that matches the Hightouch API specification for creating sources. The endpoint requires Bearer Token authentication via the Authorization: Bearer {token} header, which is handled automatically by your credential configuration. The Content-Type: application/json header is automatically included in requests. Batch mode is disabled by default (batch.mode: false), so each record will be sent as a separate request. For detailed information about creating sources, including required fields, field names, and request formats, see the Hightouch API documentation.

Create Model

Create a new model in your Hightouch workspace.

• This endpoint automatically creates a new model in your Hightouch workspace using data from your Nexset. No additional configuration is required beyond selecting this endpoint template.
• The endpoint uses POST requests to https://api.hightouch.com/api/v1/models. The endpoint URL is automatically constructed based on the Hightouch API base URL.
• The endpoint sends data from your Nexset as the request body in JSON format. The request body is automatically formatted according to the schema fields and data mapping you configure. Each record in your Nexset will be sent as a JSON object containing the model data to create.
• Batch mode is disabled by default for this endpoint. Each record in your Nexset will be sent as a separate API request to create a model. If you need to create multiple models, you can send multiple records, but each will be processed as a separate request.
• This endpoint does not automatically create a data source to track the responses received from the Hightouch API after each call.

The request body must be properly formatted JSON that matches the Hightouch API specification for creating models. The endpoint requires Bearer Token authentication via the Authorization: Bearer {token} header, which is handled automatically by your credential configuration. The Content-Type: application/json header is automatically included in requests. Batch mode is disabled by default (batch.mode: false), so each record will be sent as a separate request. For detailed information about creating models, including required fields, field names, and request formats, see the Hightouch API documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to send a test payload. The result will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the destination is configured correctly before saving.

Manual configuration

Hightouch destinations can also be manually configured to send data to any valid Hightouch API endpoint. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, data format, endpoint URL, request headers, attribute exclusions, record batching, and response webhooks.

Hightouch API endpoints typically follow the pattern https://api.hightouch.com/api/v1/{endpoint_path} and expect JSON request bodies. The endpoint requires Bearer Token authentication via the Authorization: Bearer {token} header, which is handled automatically by your credential configuration. For detailed information about Hightouch API endpoints and available APIs, see the Hightouch API documentation.

Save & activate

Once all endpoint settings have been configured, click the Done button in the upper right corner of the screen to save and create the destination. To send the data to the configured Hightouch endpoint, open the destination resource menu, and select Activate.

The Nexset data will not be sent to the Hightouch endpoint until the destination is activated. Destinations can be activated immediately or at a later time, providing full control over data movement.