LinkPath
API v1

Developer Documentation

Everything you need to integrate with the LinkPath API — connect TikTok ad accounts, manage campaigns programmatically, and receive real-time event notifications via webhooks.

Getting StartedAPI ReferenceAuthenticationRate LimitsSDKs & LibrariesWebhooks

Getting Started

Quickstart

LinkPath Manager connects to your TikTok Ads account via TikTok's Marketing API. To begin, you'll authorize LinkPath through a standard OAuth 2.0 flow — no manual API keys required for end users.

  1. 1Create a LinkPath account and navigate to the Dashboard.
  2. 2Connect your TikTok account — you'll be redirected to TikTok to grant advertising permissions. LinkPath requests read and write access to your ad accounts.
  3. 3Select your ad account from the account picker. If you manage multiple advertiser IDs, you can switch between them at any time.
  4. 4Start managing campaigns — create, edit, and monitor your TikTok ad campaigns directly from the LinkPath dashboard.

API Reference

Reference

The LinkPath API wraps TikTok's Marketing API with a simplified interface. All endpoints require a valid Bearer token and return JSON. Base URL: https://api.linkpath.io/v1

GET/POST/campaigns

List, create, update, and delete TikTok ad campaigns. Supports filtering by status, objective, and date range.

GET/POST/adgroups

Manage ad groups within a campaign. Configure targeting, bidding strategy, placement, and daily budgets.

GET/POST/ads

Create and manage individual ads. Upload creatives, set ad copy, destination URLs, and call-to-action types.

GET/reporting

Pull performance metrics including impressions, clicks, spend, conversions, ROAS, and CPM across any date range with custom dimension breakdowns.

Authentication

OAuth 2.0

LinkPath uses the OAuth 2.0 Authorization Code flow to authenticate with TikTok on your behalf. When you connect your account, TikTok issues an access token and refresh token that LinkPath stores securely.

Access Tokens

Short-lived tokens (24-hour TTL) used to authenticate all API requests. Sent as a Authorization: Bearer <token> header on every request.

Refresh Tokens

Long-lived tokens used to obtain new access tokens automatically when they expire. LinkPath handles token refresh transparently — you will not be prompted to re-authenticate unless you revoke access or the refresh token expires after 30 days of inactivity.

Revoking Access

You can disconnect your TikTok account at any time from the LinkPath dashboard settings. This immediately revokes all stored tokens.

Rate Limits

Limits

LinkPath enforces rate limits to ensure fair usage and stable performance for all users. Limits are applied per authenticated account.

ScopeLimitWindow
Standard requests1,000 reqper minute
Reporting queries100 reqper minute
Asset uploads50 reqper minute
Burst allowance200 reqper 10 seconds

When a rate limit is exceeded, the API returns a 429 Too Many Requests response with a Retry-After header indicating when you may retry. Underlying TikTok API rate limits also apply and may be more restrictive depending on your TikTok account tier.

SDKs & Libraries

Coming Soon

Official LinkPath SDK packages are currently in development. They will provide typed wrappers around the REST API, automatic token management, retry logic, and pagination helpers.

Python

pip install linkpath
In development

Node.js

npm install linkpath
In development

In the meantime, any HTTP client can be used with the REST API. Join the waitlist or check back for SDK release announcements.

Webhooks

Real-time

LinkPath Webhooks deliver real-time event notifications to your endpoint whenever key changes occur in your connected TikTok ad account. Configure a webhook URL in your account settings and we will POST a signed JSON payload for each event.

Supported events

campaign.status_changed

Fired when a campaign transitions between ACTIVE, PAUSED, or DELETED states.

adgroup.status_changed

Fired when an ad group status changes, including budget exhaustion or schedule expiry.

ad.approved

Fired when a newly submitted ad creative passes TikTok review and goes live.

ad.rejected

Fired when an ad is rejected during review, including the rejection reason code.

budget.threshold_reached

Fired when daily or lifetime spend crosses a configured alert threshold.

All webhook payloads are signed with an X-LinkPath-Signature header using HMAC-SHA256. Verify this signature on your server to ensure the payload originated from LinkPath.

Need help?

Can't find what you're looking for? Reach out to the LinkPath Media developer support team and we'll help you get integrated.

Contact Developer Support