UpPromote

UpPromote is an affiliate marketing platform designed for e-commerce businesses, providing tools to create and manage affiliate programs, track referrals, process commissions, and grow sales through partner networks.

Power end-to-end data operations for your UpPromote API with Nexla. Our bi-directional UpPromote connector is purpose-built for UpPromote, 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 UpPromote or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your UpPromote 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 UpPromote credential, you need to obtain your Bearer Token from your UpPromote account. UpPromote uses Bearer token authentication for all API requests.

To obtain your UpPromote Bearer Token, follow these steps:

1. Sign in to your UpPromote account using your administrator credentials.

2. Navigate to Integrations in your UpPromote account dashboard, typically accessible from the main navigation menu or settings.

3. In the Integrations section, navigate to the APIs tab or API Settings to access API token management.

4. Look for the API Token or Bearer Token section in your UpPromote API settings.

5. If you don't have an API token yet, click Generate Token or Create API Token to create a new API token.

6. Configure your token settings:

   • Enter a name for the token (e.g., "Nexla Integration")
   • Review the token permissions or scopes (if applicable)
   • Click Create or Generate to create the token

7. After the token is created, copy the Bearer Token or API Token value immediately, as it may not be accessible again after you navigate away from the page.

8. Store the token securely, as you will need it to configure your Nexla credential. The Bearer Token is sensitive information and should be kept confidential.

The Bearer Token is sent in the Authorization header for all API requests to the UpPromote API. The token authenticates your requests and grants access to UpPromote resources based on your account permissions. If your token is compromised, you should immediately revoke it in your UpPromote account settings and generate a new one. For detailed information about obtaining API tokens, API authentication, and available endpoints, refer to the UpPromote API documentation.

Authenticate

Credentials required

Field	Required	Secret	Description
Uppromote Bearer Token	Yes	Yes	Enter the token generated that authorizes your application. Click on Integrations, go to APIs tab and copy the API token.

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 – UpPromote

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 UpPromote Bearer Token in the Uppromote Bearer Token field. This is the token generated that authorizes your application, obtained in Prerequisites from Integrations > APIs tab. The token is sent as a Bearer token in the Authorization header for all API requests to the UpPromote API and must be kept confidential.

   If your token is compromised, you should immediately revoke it in your UpPromote account settings and generate a new one. The Bearer Token provides access to your UpPromote account data and should be treated as sensitive information. Keep your token secure and do not share it publicly.

   For detailed information about obtaining API tokens, API authentication, and available endpoints, see the UpPromote API documentation and UpPromote API overview.

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

Get All Affiliates

This endpoint template retrieves all affiliates in the account from your UpPromote account. Use this template when you need to access affiliate information, affiliate status, or affiliate metadata for analysis, reporting, or integration purposes.

• This endpoint automatically retrieves all affiliates in the account from your UpPromote account. No additional configuration is required beyond selecting this endpoint template. The endpoint uses incrementing page number pagination to handle large datasets efficiently, returning up to 100 records per page by default.

This endpoint returns all affiliates in the account from your UpPromote account, including affiliate IDs, names, status, and other affiliate metadata. The endpoint uses incrementing page number pagination with page and limit parameters to handle large datasets efficiently. Nexla will automatically follow the pagination to fetch subsequent pages of data.

For detailed information about affiliates, API response structures, pagination, and available affiliate data, see the UpPromote API documentation.

Get Affiliate

This endpoint template retrieves a specific affiliate by ID from your UpPromote account. Use this template when you need to access detailed affiliate information, affiliate status, or affiliate metadata for a specific affiliate for analysis, reporting, or integration purposes.

• Optionally enter the Affiliate_Id in the Affiliate_Id field. This should be the unique identifier of the affiliate you want to retrieve. The Affiliate_Id determines which affiliate's information will be retrieved. If left empty, the endpoint may return default or all available affiliates.

This endpoint returns a specific affiliate by ID from your UpPromote account, including affiliate IDs, names, status, and other affiliate metadata. The Affiliate_Id identifies the specific affiliate whose information will be retrieved.

For detailed information about affiliates, API response structures, and available affiliate data, see the UpPromote API documentation.

Search Affiliate

This endpoint template uses optional query parameters to search for an affiliate from your UpPromote account. The keyword searches for the Affiliate name or affiliate email. Use this template when you need to find affiliates by name or email for analysis, reporting, or integration purposes.

• Optionally enter the Optional Search Query in the Optional Search Query field. This should be the search query for searching an affiliate. The keyword searches for the Affiliate name or affiliate email. The Search Query determines which affiliates will be returned in the search results. If left empty, the endpoint may return default or all available affiliates.

This endpoint uses optional query parameters to search for an affiliate from your UpPromote account, allowing you to find affiliates by name or email. The keyword searches for the Affiliate name or affiliate email. The search results can be used to find specific affiliates or filter affiliate lists.

For detailed information about affiliate search, API response structures, and available search options, see the UpPromote 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

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

Add Affiliate

This endpoint template adds an affiliate from records in a Nexset in your UpPromote account. Use this template when you need to automatically create affiliates based on data from your Nexla flows.

• This endpoint sends data as JSON in the request body to create new affiliates. Each record from your Nexset will be sent as a separate API request to add an affiliate. The request body should contain the affiliate data in the format required by the UpPromote API, including all required properties for affiliate creation.

This endpoint sends data as JSON in the request body to add new affiliates in your UpPromote account. Each record from your Nexset will be sent as a separate API request to add an affiliate. The request body should contain the affiliate data in the format required by the UpPromote API, including all required properties for affiliate creation.

The affiliate structure must match the UpPromote API's expected format. Ensure your affiliate data includes all required fields. For detailed information about affiliate creation, request body formats, and available affiliate properties, see the UpPromote API documentation.

Manual configuration

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

UpPromote APIs typically expect JSON format for most operations. For update/upsert operations, include the ID of the object to be updated at the end of the URL.

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

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