PartnerStack

PartnerStack is a partner relationship management platform for running affiliate, referral, and reseller programs. Its REST API exposes partnerships, customers, deals, leads, and tracked actions, letting you sync partner program data with your own systems. This connector reads from and writes to PartnerStack using pre-built endpoint templates.

Power end-to-end data operations for your PartnerStack API with Nexla. Our bi-directional PartnerStack connector is purpose-built for PartnerStack, 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 PartnerStack or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your PartnerStack 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 PartnerStack credential, you need a public key and secret key from your PartnerStack Vendor account. The PartnerStack REST API (v2, https://api.partnerstack.com/api/v2) uses HTTP Basic authentication, with the public key as the username and the secret key as the password, combined and Base64-encoded in the Authorization header.

To obtain your PartnerStack API keys, follow these steps:

1. Sign in to your PartnerStack Vendor dashboard using your administrator credentials.

2. Navigate to Settings > Integrations > PartnerStack API Keys.

3. Locate your Public Key and Secret Key. PartnerStack provides separate Test and Production keys; use the pair that matches the environment you intend to connect to.

4. Copy both keys and store them securely. The secret key is sensitive and should never be exposed in client-side code, public repositories, or any publicly accessible location.

For detailed information about API authentication and available endpoints, see the PartnerStack Vendor API documentation.

Authenticate

Credentials required

Field	Required	Secret	Description
API Key Value	Yes	Yes	An encoded string value used as a secret token to authenticate API requests

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 PartnerStack API key in the API Key Value field. This is the secret token used to authenticate your requests to the PartnerStack API and must be kept confidential.

   The PartnerStack Vendor API uses HTTP Basic authentication, formed from your public key and secret key. Keep your secret key confidential and never expose it in client-side code or public repositories. If a key is compromised, rotate it from your PartnerStack integration settings.

   For detailed information about API authentication and available endpoints, see the PartnerStack Vendor 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.

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

This endpoint template retrieves a list of actions (conversions, referrals, and other tracked events) recorded in your PartnerStack account. Use this template when you need to sync action data for reporting, reconciliation, or analytics.

[Rest API] Get an action

This endpoint template retrieves a single action from your PartnerStack account by its key. Use this template when you need to fetch the full details of a specific tracked action.

[Rest API] List partnership applications

This endpoint template retrieves a list of partnership applications submitted to your PartnerStack program. Use this template when you need to review or sync pending, approved, and rejected applications.

[Rest API] List customers

This endpoint template retrieves a list of customers tracked in your PartnerStack account. Use this template when you need to sync customer records for attribution, reporting, or downstream systems.

[Rest API] Get a customer

This endpoint template retrieves a single customer from your PartnerStack account by its key. Use this template when you need the full details of a specific customer.

[Rest API] List deals

This endpoint template retrieves a list of deals registered in your PartnerStack account. Use this template when you need to sync deal registration data for pipeline reporting or CRM integration.

[Rest API] Get a deal

This endpoint template retrieves a single deal from your PartnerStack account by its key. Use this template when you need the full details of a specific deal.

[Rest API] List files for a deal

This endpoint template retrieves the list of files attached to a specific deal in your PartnerStack account. Use this template when you need to enumerate documents associated with a deal.

[Rest API] Get a deal file

This endpoint template retrieves a single file attached to a deal in your PartnerStack account. Use this template when you need to fetch a specific deal document.

[Rest API] List deal form templates

This endpoint template retrieves the deal form templates configured in your PartnerStack account. Use this template when you need to reference the form structures used for deal registration.

[Rest API] List distributor listing categories

This endpoint template retrieves the distributor listing categories available in your PartnerStack account. Use this template when you need to reference the categories used to organize distributor listings.

[Rest API] Export base records

This endpoint template initiates an export of base records from your PartnerStack account. Use this template when you need to bulk-export core records for downstream processing or archival.

[Rest API] List form templates

This endpoint template retrieves the form templates configured in your PartnerStack account. Use this template when you need to reference the available form structures.

[Rest API] List partner groups

This endpoint template retrieves the partner groups defined in your PartnerStack account. Use this template when you need to sync the groups used to segment and manage partners.

[Rest API] List leads

This endpoint template retrieves a list of leads tracked in your PartnerStack account. Use this template when you need to sync lead data for reporting or CRM integration.

[Rest API] Get a lead

This endpoint template retrieves a single lead from your PartnerStack account by its key. Use this template when you need the full details of a specific lead.

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

PartnerStack data sources can also be manually configured to ingest data from any valid PartnerStack 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 PartnerStack 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 PartnerStack destination, and select the Send to Destination option from the menu. Select the PartnerStack connector from the list of available destination connectors, then select the credential that will be used to connect to the PartnerStack account, and click Next; or, create a new PartnerStack 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 PartnerStack 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] Create an action

This endpoint template creates a new action (such as a conversion or referral event) in your PartnerStack account using records from a Nexset. Use this template to push tracked events into PartnerStack from your Nexla flows.

[Rest API] Delete an action

This endpoint template deletes an action from your PartnerStack account. Use this template to remove tracked action records driven by data from your Nexla flows.

[Rest API] Create a partnership application

This endpoint template creates a new partnership application in your PartnerStack account using records from a Nexset. Use this template to submit partner applications programmatically.

[Rest API] Approve or reject an application

This endpoint template updates the decision on a partnership application, approving or rejecting it, using records from a Nexset. Use this template to automate application review outcomes.

[Rest API] Approve or reject a specific application

This endpoint template updates the decision on a specific partnership application identified by its key, approving or rejecting it. Use this template to automate the review outcome for a targeted application.

[Rest API] Create a customer

This endpoint template creates a new customer in your PartnerStack account using records from a Nexset. Use this template to push customer records into PartnerStack from your Nexla flows.

[Rest API] Update a customer

This endpoint template updates an existing customer in your PartnerStack account using records from a Nexset. Use this template to keep customer records in sync with your source systems.

[Rest API] Delete a customer

This endpoint template deletes a customer from your PartnerStack account. Use this template to remove customer records driven by data from your Nexla flows.

[Rest API] Create a deal

This endpoint template creates a new deal in your PartnerStack account using records from a Nexset. Use this template to register deals programmatically from your Nexla flows.

[Rest API] Update a deal

This endpoint template updates an existing deal in your PartnerStack account using records from a Nexset. Use this template to keep deal records in sync with your source systems.

[Rest API] Delete a deal

This endpoint template deletes a deal from your PartnerStack account. Use this template to remove deal records driven by data from your Nexla flows.

[Rest API] Convert a deal

This endpoint template converts an existing deal in your PartnerStack account, advancing it to a converted state, using records from a Nexset. Use this template to automate deal conversion from your Nexla flows.

[Rest API] Assign a deal to a partnership stack

This endpoint template assigns a deal to a partnership in your PartnerStack account using records from a Nexset. Use this template to automate deal-to-partner assignment.

[Rest API] Create a lead

This endpoint template creates a new lead in your PartnerStack account using records from a Nexset. Use this template to push lead records into PartnerStack from your Nexla flows.

Manual configuration

PartnerStack destinations can also be manually configured to send data to any valid PartnerStack 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 PartnerStack endpoint, open the destination resource menu, and select Activate.

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