Skip to main content

Integrate

Integrate is a B2B demand-generation and lead-management platform that captures, validates, and routes leads across campaigns and contracts, manages suppression and target lists, and delivers governed leads to CRMs and marketing automation platforms. The Integrate connector lets Nexla read leads reports, campaigns (contracts), and lists, and write new leads, dispositions, and list values back to Integrate.

Integrate icon

Power end-to-end data operations for your Integrate API with Nexla. Our bi-directional Integrate connector is purpose-built for Integrate, 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 Integrate or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Integrate 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 an Integrate credential, you need an API Key and API Key Secret issued by Integrate for your organization. Integrate's REST API authenticates each request with these two values, sent as the X-API-Key and X-API-Key-Secret headers.

Integrate retired the legacy Bearer-token and API-Key-only authentication methods on 31 December 2025. New integrations must use the paired API Key and API Key Secret described here.

To prepare for creating a credential in Nexla:

  1. Sign in to your Integrate account with an administrator or API-enabled user.

  2. Obtain your API Key and API Key Secret from your Integrate account. These are issued per organization and are used together to authenticate API requests. If you do not have API credentials, contact your Integrate administrator or Integrate support to have them provisioned.

  3. Note your Organization ID. Most Integrate API endpoints are scoped to an organization, and this identifier is required when configuring several of the source and destination endpoints in Nexla.

  4. Store the API Key and API Key Secret securely. The API Key Secret is sensitive and grants access to your organization's lead and campaign data, so treat it as confidential.

For complete information about Integrate's API authentication and available endpoints, see the Integrate API documentation.

Authenticate

Credentials required

FieldRequiredSecretDescription
API KeyYesYesIntegrate API Key, sent as the X-API-Key header.
API Key SecretYesYesIntegrate API Key Secret, sent as the X-API-Key-Secret header (paired with the API Key).

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.

  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 Integrate API Key in the API Key field. This value is sent as the X-API-Key header on every API request.

  4. Enter your Integrate API Key Secret in the API Key Secret field. This value is sent as the X-API-Key-Secret header and is paired with the API Key to authenticate requests.

    The API Key Secret provides access to your Integrate organization's lead, campaign, and list data and should be kept confidential. If it is compromised, rotate the credential in Integrate and update it in Nexla.

  5. 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.

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 Integrate connector tile, then select the credential that will be used to connect to your Integrate organization, and click Next; or, create a new Integrate 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 Integrate 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.

[Rest API] List Reports

List all reports configured for an organization. Use this template to discover the reports available in your Integrate organization before generating or downloading their data.

  • Enter your Integrate Organization ID in the required Organization ID field to scope the request to your organization.
  • This endpoint returns paginated results, and Nexla automatically iterates through the pages to retrieve all configured reports.

[Rest API] List Lists

List all Lists (suppression, target, domain, or general) for an organization. Use this template to retrieve the Lists used to govern and filter leads in your Integrate organization.

  • Enter your Integrate Organization ID in the required Organization ID field to scope the request to your organization.
  • This endpoint returns paginated results, and Nexla automatically iterates through the pages to retrieve all Lists.

[Rest API] Get List Values

Get all values for a single List. Use this template to retrieve the individual entries (for example, suppressed domains or target accounts) contained in a specific List.

  • Enter your Integrate Organization ID in the required Organization ID field.
  • Enter the List ID of the List whose values you want to retrieve in the required List ID field. You can obtain List IDs from the List Lists endpoint.

[Rest API] List Campaigns (Contracts)

List all Contracts (campaign, publisher, and buyer allocations) for an organization. Use this template to retrieve the campaigns and programs configured in your Integrate organization.

  • Enter your Integrate Organization ID in the required Organization ID field to scope the request to your organization.
  • This endpoint returns paginated results, and Nexla automatically iterates through the pages to retrieve all Contracts.

[Rest API] Get Campaign (Contract) by ID

Get a single Contract's details, including campaign, publisher, and buyer information. Use this template to retrieve the full configuration of one specific campaign.

  • Enter your Integrate Organization ID in the required Organization ID field.
  • Enter the Contract/Campaign ID of the Contract you want to retrieve in the required Contract/Campaign ID field. You can obtain Contract IDs from the List Campaigns (Contracts) endpoint.

[Rest API] Get Leads Report File

Get metadata, including the download URL, for a generated leads report file. Use this template after a report has been generated to locate and access the resulting file.

  • Enter the Report Auth Token for the generated report file in the required Report Auth Token field. This token is returned when a report file is generated in Integrate.

[Rest API] Download Leads

Download leads for one or more contracts/campaigns as a CSV file, optionally filtered by status. Use this template to pull captured leads into Nexla for downstream processing or delivery.

  • Optionally enter a lead status in the Status Filter field (for example, accepted or rejected) to return only leads with that status.
  • Optionally enter a comma-separated list of contract IDs in the Contract IDs Filter field to restrict the download to specific contracts/campaigns.

This endpoint returns CSV-formatted data rather than JSON. Leave the filters empty to download leads across all contracts.

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

Integrate data sources can also be manually configured to ingest data from any valid Integrate API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. 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.

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 Integrate 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 Integrate destination, and select the Send to Destination option from the menu. Select the Integrate connector from the list of available destination connectors, then select the credential that will be used to connect to your Integrate organization, and click Next; or, create a new Integrate 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 Integrate 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.

[Rest API] Submit Lead

Submit a new lead to a campaign (contract). Use this template to push leads captured or enriched in your Nexla flows into a specific Integrate campaign.

  • Enter the Contract/Campaign ID of the campaign that the leads should be submitted to in the required Contract/Campaign ID field.
  • Each record from your Nexset is sent as a separate JSON request body to create a new lead in the specified campaign.

[Rest API] Upload Lead Disposition

Update the status or disposition code of a single lead. Use this template to send lead acceptance, rejection, or other disposition outcomes back to Integrate.

  • Enter your Integrate Organization ID in the required Organization ID field to scope the request to your organization.
  • Each record from your Nexset is sent as a separate JSON request body containing the lead's disposition details.

[Rest API] Create List

Create a new List (domain, general, suppression, or target) for use with Sources. Use this template to build the Lists that govern and filter leads in your Integrate organization.

  • Enter your Integrate Organization ID in the required Organization ID field to scope the request to your organization.
  • Each record from your Nexset is sent as a separate JSON request body defining the new List.

[Rest API] Edit List Values

Edit, add, or replace values in an existing List. Use this template to keep suppression, target, domain, or general Lists up to date from your Nexla flows.

  • Enter your Integrate Organization ID in the required Organization ID field.
  • Enter the List ID of the List whose values you want to edit in the required List ID field. You can obtain List IDs from the List Lists source endpoint.
  • Each record from your Nexset is sent as a JSON request body containing the values to add, edit, or replace.

Manual configuration

Integrate destinations can also be manually configured to send data to any valid Integrate 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.

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 Integrate endpoint, open the destination resource menu, and select Activate.

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