TikTok Marketing

The TikTok Marketing API (TikTok Business API) lets advertisers programmatically manage advertising on TikTok, including advertisers, campaigns, ad groups, ads, audiences, and creative assets. Nexla connects to the TikTok Marketing API to ingest advertising data for reporting and analytics, and to create and update campaigns, ad groups, and ads.

Power end-to-end data operations for your TikTok Marketing API with Nexla. Our bi-directional TikTok Marketing connector is purpose-built for TikTok Marketing, 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 TikTok Marketing or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your TikTok Marketing 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 TikTok Marketing credential, you need a TikTok Business API access token and the API base URL. The access token is sent in the Access-Token header on every request. TikTok issues access tokens through an OAuth 2.0 advertiser-authorization flow, in which an advertiser grants your developer app permission to manage their advertising accounts.

To obtain your TikTok Marketing API credentials, follow these steps:

1. Register a developer account and create an app in the TikTok for Business Developers portal. Creating an app produces an App ID and App Secret, and lets you configure the redirect URI and the scopes your app requires.

2. Direct the advertiser to TikTok's OAuth authorization page, where they log in and approve the scopes your app requests. After approval, TikTok redirects to your configured redirect URI with a short-lived authorization code in the query string.

3. Exchange the authorization code for an access token by calling the token endpoint at https://business-api.tiktok.com/open_api/v1.3/oauth2/access_token/ with your App ID, App Secret, and the authorization code. The response returns the access token along with the list of advertiser IDs the token is authorized to manage.

4. Note the API base URL, which is https://business-api.tiktok.com. Nexla combines this with the request path for each endpoint.

5. Store the access token securely. It authenticates all requests and grants access to the advertising accounts and scopes the advertiser approved. If the token is compromised, revoke the authorization and generate a new one.

For detailed information about app registration, OAuth authorization, token management, and available endpoints, see the TikTok Marketing API documentation and the TikTok API authorization guide.

Authenticate

Credentials required

Field	Required	Secret	Description
Access Token	Yes	Yes	TikTok Business API access token, sent via the Access-Token header.
Base URL	Yes	No	API base URL.

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 TikTok Business API access token in the Access Token field. This token is sent in the Access-Token header for all requests to the TikTok Marketing API and must be kept confidential.

4. Enter the API base URL in the Base URL field. For the TikTok Marketing API this is https://business-api.tiktok.com.

   If your access token is compromised, revoke the advertiser authorization in your TikTok developer app and generate a new token. The access token grants access to the advertising accounts and scopes the advertiser approved, and should be treated as sensitive information.

   For detailed information about OAuth authorization, token management, and available endpoints, see the TikTok Marketing API documentation.

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

This endpoint template retrieves advertiser accounts that the credential is authorized to access. Use this template to discover the advertiser IDs available to your token before configuring flows that operate on specific advertisers.

For detailed information about advertiser data, response structures, and pagination, see the TikTok Marketing API documentation.

[Rest API] List Campaigns

This endpoint template retrieves campaigns for an advertiser. Use this template when you need to access campaign information for analysis, reporting, or integration purposes.

For detailed information about campaign data, response structures, and pagination, see the TikTok Marketing API documentation.

[Rest API] List Ad Groups

This endpoint template retrieves ad groups for an advertiser. Use this template when you need to access ad group information, including targeting and budget settings, for analysis or reporting.

For detailed information about ad group data, response structures, and pagination, see the TikTok Marketing API documentation.

[Rest API] List Ads

This endpoint template retrieves ads for an advertiser. Use this template when you need to access ad-level information for analysis, reporting, or integration purposes.

For detailed information about ad data, response structures, and pagination, see the TikTok Marketing API documentation.

[Rest API] List Audiences

This endpoint template retrieves audiences for an advertiser. Use this template when you need to access audience definitions for analysis, reporting, or integration purposes.

For detailed information about audience data, response structures, and pagination, see the TikTok Marketing API documentation.

[Rest API] List Creative Assets Video

This endpoint template searches video creatives in the Asset Library for an advertiser. Use this template when you need to access video creative assets for analysis, reporting, or integration purposes.

For detailed information about creative asset data, response structures, and pagination, see the TikTok Marketing API documentation.

[Rest API] List Creative Assets Portfolios

This endpoint template retrieves creative asset portfolios for an advertiser. Use this template when you need to access grouped creative assets for analysis, reporting, or integration purposes.

For detailed information about creative asset portfolio data, response structures, and pagination, see the TikTok Marketing 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

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

This endpoint template creates a new advertising campaign using records from a Nexset. Each record is sent as a separate API request. The request body must contain the campaign data in the format required by the TikTok Marketing API, including the advertiser ID and campaign settings.

The campaign structure must match the TikTok Marketing API's expected format. For detailed information about campaign creation and request body formats, see the TikTok Marketing API documentation.

[Rest API] Update Campaign

This endpoint template updates an existing advertising campaign using records from a Nexset. Each record is sent as a separate API request. The request body must include the campaign ID and the fields to update, in the format required by the TikTok Marketing API.

The request body must match the TikTok Marketing API's expected format. For detailed information about campaign updates and request body formats, see the TikTok Marketing API documentation.

[Rest API] Create Ad Group

This endpoint template creates a new ad group within a campaign using records from a Nexset. Each record is sent as a separate API request. The request body must contain the ad group data, including the parent campaign ID, targeting, and budget settings, in the format required by the TikTok Marketing API.

The ad group structure must match the TikTok Marketing API's expected format. For detailed information about ad group creation and request body formats, see the TikTok Marketing API documentation.

[Rest API] Create Ad

This endpoint template creates a new ad within an ad group using records from a Nexset. Each record is sent as a separate API request. The request body must contain the ad data, including the parent ad group ID and creative details, in the format required by the TikTok Marketing API.

The ad structure must match the TikTok Marketing API's expected format. For detailed information about ad creation and request body formats, see the TikTok Marketing API documentation.

[Rest API] Update Ad Status

This endpoint template enables, disables, or deletes ads by updating their status using records from a Nexset. Each record is sent as a separate API request. The request body must include the ad identifiers and the target status, in the format required by the TikTok Marketing API.

The request body must match the TikTok Marketing API's expected format. For detailed information about updating ad status and request body formats, see the TikTok Marketing API documentation.

Manual configuration

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

TikTok Marketing API endpoints expect JSON format for write operations. Include the required identifiers (such as advertiser ID, campaign ID, or ad group ID) in the request body as specified by the API.

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

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