TikTok Marketing API Campaign Creation API
The Campaign Creation API from TikTok Marketing API — 15 operation(s) for campaign creation.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/tiktok-ads-campaign-creation-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: TikTok API for Business — Marketing Campaign Creation API
description: TikTok API for Business (Marketing API) v1.3. This document is a mechanical union of the 202 per-operation OpenAPI 3.0.1 documents TikTok publishes in yml_files/ of its own SDK repository (https://github.com/tiktok/tiktok-business-api-sdk), which are the swagger-codegen inputs for TikTok's first-party Java/Python/JavaScript SDKs. Operation content (paths, parameters, responses, tags and the x-open-* extensions) is preserved verbatim; only info, servers and components.securitySchemes were written by API Evangelist, because the per-operation fragments carry placeholder info blocks and no servers block. The servers values are the production and sandbox base URLs TikTok documents at https://business-api.tiktok.com/portal/docs?id=1738855331457026 .
version: v1.3
contact:
name: TikTok API for Business support
url: https://business-api.tiktok.com/portal/docs?id=1795190020378625
termsOfService: https://business-api.tiktok.com/portal/docs?id=1737191804348417
x-source: https://github.com/tiktok/tiktok-business-api-sdk/tree/main/yml_files
x-harvested-by: API Evangelist enrichment pipeline
x-harvested: '2026-08-13'
servers:
- url: https://business-api.tiktok.com/open_api/v1.3
description: Production
- url: https://sandbox-ads.tiktok.com/open_api/v1.3
description: Sandbox
security:
- AccessToken: []
tags:
- name: Campaign Creation
paths:
/campaign/gmv_max/create/:
post:
operationId: Campaign Gmv_max Create
parameters:
- description: Authorized access token. For details, see [Authentication](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162).
in: query
name: Access-Token
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
properties:
advertiser_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 1
x-open-source: $.http.body.gmv_max_data.advertiser_id
affiliate_posts_enabled:
description: ''
type: boolean
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int32(%s)
x-open-field-id: 19
auto_budget_enabled:
description: ''
type: boolean
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 22
budget:
description: ''
format: double
type: number
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 12
x-open-source: $.http.body.gmv_max_data.budget
campaign_name:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 2
x-open-source: $.http.body.gmv_max_data.campaign_name
custom_anchor_video_list:
description: ''
items:
properties:
identity_info:
description: ''
properties:
identity_authorized_bc_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 3
identity_authorized_shop_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 5
identity_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 1
identity_type:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: 1800331041544193
enum_package_name: IdentityType
enums:
- description: ''
is_valid: true
key: AUTH_CODE
value: '2'
- description: ''
is_valid: true
key: BC_AUTH_TT
value: '5'
- description: ''
is_valid: false
key: BC_SELF_TT
value: '4'
- description: ''
is_valid: false
key: CUSTOMIZED_USER
value: '1'
- description: TTS 授权来源TT账号
is_valid: true
key: TTS_TT
value: '8'
- description: ''
is_valid: true
key: TT_USER
value: '3'
- description: ''
is_valid: false
key: UNSET
value: '0'
key_format: string
strict: true
use_part: true
validate_only: false
value_format: int32
x-open-field-id: 2
store_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 4
required:
- identity_id
- identity_type
type: object
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 3
item_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 1
spu_id_list:
description: ''
items:
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
maxItems: 1
minItems: 1
type: array
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 2
type: object
x-open-allow-strlist: false
x-open-allow-strnum: false
maxItems: 2000
type: array
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 20
deep_bid_type:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: 1804193389572097
enum_package_name: DeepBidType
enums:
- description: AEO直投出价
is_valid: false
key: AEO
value: '101'
- description: 标准出价
is_valid: false
key: DEFAULT
value: '0'
- description: 自定义出价
is_valid: false
key: MIN
value: '1'
- description: 动态出价
is_valid: false
key: PACING
value: '2'
- description: 非中VO highest value
is_valid: false
key: VO_HIGHEST_VALUE
value: '109'
- description: ROI自动出价，非中含义为VO target CPA
is_valid: false
key: VO_MIN
value: '7'
- description: 非中VO minRoas
is_valid: true
key: VO_MIN_ROAS
value: '108'
key_format: string
strict: true
use_part: true
validate_only: false
value_format: int32
x-open-field-id: 10
x-open-source: $.http.body.gmv_max_data.deep_bid_type
identity_list:
description: ''
items:
properties:
identity_authorized_bc_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 3
x-open-source: $.http.body.gmv_max_data.identity_list[].identity_authorized_bc_id
identity_authorized_shop_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 5
x-open-source: $.http.body.gmv_max_data.identity_list[].identity_authorized_shop_id
identity_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 1
x-open-source: $.http.body.gmv_max_data.identity_list[].identity_id
identity_type:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: 1800331041544193
enum_package_name: IdentityType
enums:
- description: ''
is_valid: true
key: AUTH_CODE
value: '2'
- description: ''
is_valid: true
key: BC_AUTH_TT
value: '5'
- description: ''
is_valid: false
key: BC_SELF_TT
value: '4'
- description: ''
is_valid: false
key: CUSTOMIZED_USER
value: '1'
- description: TTS 授权来源TT账号
is_valid: true
key: TTS_TT
value: '8'
- description: ''
is_valid: true
key: TT_USER
value: '3'
- description: ''
is_valid: false
key: UNSET
value: '0'
key_format: string
strict: true
use_part: true
validate_only: false
value_format: int32
x-open-field-id: 2
x-open-source: $.http.body.gmv_max_data.identity_list[].identity_type
store_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 4
x-open-source: $.http.body.gmv_max_data.identity_list[].store_id
required:
- identity_id
- identity_type
type: object
x-open-allow-strlist: false
x-open-allow-strnum: false
type: array
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 6
x-open-source: $.http.body.gmv_max_data.identity_list
item_group_ids:
description: ''
items:
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
maxItems: 50
minItems: 1
type: array
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 9
x-open-source: $.http.body.gmv_max_data.spu_list
item_list:
description: ''
items:
properties:
identity_info:
description: ''
properties:
identity_authorized_bc_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 3
x-open-source: $.http.body.gmv_max_data.shop_item_list[].identity_info.identity_authorized_bc_id
identity_authorized_shop_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 5
identity_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 1
x-open-source: $.http.body.gmv_max_data.shop_item_list[].identity_info.identity_id
identity_type:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: 1800331041544193
enum_package_name: IdentityType
enums:
- description: ''
is_valid: true
key: AUTH_CODE
value: '2'
- description: ''
is_valid: true
key: BC_AUTH_TT
value: '5'
- description: ''
is_valid: false
key: BC_SELF_TT
value: '4'
- description: ''
is_valid: false
key: CUSTOMIZED_USER
value: '1'
- description: TTS 授权来源TT账号
is_valid: true
key: TTS_TT
value: '8'
- description: ''
is_valid: true
key: TT_USER
value: '3'
- description: ''
is_valid: false
key: UNSET
value: '0'
key_format: string
strict: true
use_part: true
validate_only: false
value_format: int32
x-open-field-id: 2
x-open-source: $.http.body.gmv_max_data.shop_item_list[].identity_info.identity_type
store_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 4
x-open-source: $.http.body.gmv_max_data.shop_item_list[].identity_info.store_id
required:
- identity_id
- identity_type
type: object
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 2
x-open-source: $.http.body.gmv_max_data.shop_item_list[].identity_info
item_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- int64(%s)
x-open-field-id: 1
x-open-source: $.http.body.gmv_max_data.shop_item_list[].item_id
spu_id_list:
description: ''
items:
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
type: array
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 3
x-open-source: $.http.body.gmv_max_data.shop_item_list[].spu_id_list
video_info:
description: ''
properties:
video_id:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 1
x-open-source: $.http.body.gmv_max_data.shop_item_list[].video_info.video_id
required:
- video_id
type: object
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 4
x-open-source: $.http.body.gmv_max_data.shop_item_list[].video_info
type: object
x-open-allow-strlist: false
x-open-allow-strnum: false
type: array
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 17
x-open-source: $.http.body.gmv_max_data.shop_item_list
optimization_goal:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: 1804193306612737
enum_package_name: OptimizeGoal
enums:
- description: ''
is_valid: false
key: ANCHOR_CLICK
value: '112'
- description: ''
is_valid: false
key: ANCHOR_CLICK_PURCHASE
value: '117'
- description: ''
is_valid: false
key: AUTOMATED_VALUE
value: '125'
- description: ''
is_valid: false
key: CLICK
value: '101'
- description: ''
is_valid: false
key: CONVERSATION
value: '124'
- description: ''
is_valid: false
key: CONVERSION_LEADS
value: '121'
- description: ''
is_valid: false
key: CONVERT
value: '100'
- description: ''
is_valid: false
key: DESTINATION_VISIT
value: '123'
- description: ''
is_valid: false
key: ENGAGED_VIEW
value: '118'
- description: ''
is_valid: false
key: ENGAGED_VIEW_FIFTEEM
value: '120'
- description: ''
is_valid: false
key: FOLLOWERS
value: '108'
- description: ''
is_valid: false
key: INSTALL
value: '105'
- description: ''
is_valid: false
key: IN_APP_EVENT
value: '106'
- description: ''
is_valid: false
key: LEAD_GENERATION
value: '107'
- description: ''
is_valid: false
key: MESSAGE
value: '119'
- description: ''
is_valid: false
key: MT_LIVE_FOLLOW
value: '126'
- description: ''
is_valid: false
key: MT_LIVE_ROOM
value: '113'
- description: ''
is_valid: false
key: MT_LIVE_SHOPPING
value: '116'
- description: ''
is_valid: false
key: PAGE_VISIT
value: '122'
- description: ''
is_valid: false
key: POST_ENGAGEMNT
value: '110'
- description: ''
is_valid: false
key: PREFERRED_LEAD
value: '127'
- description: ''
is_valid: false
key: PRODUCT_CLICK_IN_LIVE
value: '114'
- description: ''
is_valid: false
key: PROFILE_VIEWS
value: '109'
- description: ''
is_valid: false
key: REACH
value: '103'
- description: ''
is_valid: false
key: SHOW
value: '102'
- description: ''
is_valid: false
key: TRAFFIC_LANDING_PAGE_VIEW
value: '115'
- description: ''
is_valid: true
key: VALUE
value: '111'
- description: ''
is_valid: false
key: VIDEO_VIEW
value: '104'
key_format: string
strict: true
use_part: true
validate_only: false
value_format: int32
x-open-field-id: 7
x-open-source: $.http.body.gmv_max_data.optimize_goal
product_specific_type:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: 1807533365234690
enum_package_name: ProductSpecificType
enums:
- description: ''
is_valid: true
key: ALL
value: '1'
- description: ''
is_valid: true
key: CUSTOMIZED_PRODUCTS
value: '3'
- description: ''
is_valid: false
key: PRODUCT_SET
value: '2'
- description: ''
is_valid: false
key: UNSET
value: '0'
key_format: string
strict: true
use_part: true
validate_only: false
value_format: int32
x-open-field-id: 8
x-open-source: $.http.body.gmv_max_data.product_specific_type
product_video_specific_type:
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: 1817317969806337
enum_package_name: ProductVideoSelectionType
enums:
- description: video auto selected by automation
is_valid: true
key: AUTO_SELECTION
value: '1'
- description: video mannual selected in seller center
is_valid: true
key: CUSTOM_SELECTION
value: '2'
- description: ''
is_valid: false
key: UNSET
value: '0'
key_format: string
strict: true
use_part: true
validate_only: false
value_format: int32
x-open-field-id: 16
x-open-source: $.http.body.gmv_max_data.product_video_selection_type
promotion_days:
description: ''
properties:
auto_schedule_enabled:
default: true
description: ''
type: boolean
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-field-id: 2
custom_schedule_list:
description: ''
items:
properties:
end_date:
description: ''
format: date
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-convert:
- 'convert_time_format(%s, "yyyy-MM-dd", "yyyy-MM-dd 00:00:00", "local") '
x-open-field-id: 2
schedule_type:
default: STARTEND
description: ''
type: string
x-open-allow-strlist: false
x-open-allow-strnum: false
x-open-enum:
enum_package_expired: false
enum_package_id: null
enum_package_name: null
enums:
- description: ''
is_valid: true
key: FROMTIME
value: '1'
- description: ''
is_valid: true
key: STARTEND
value: '2'
- description: ''
is_valid: true
key: DAYS
value: '3'
- description: ''
is_valid: true
key: WEEKLY
value: '4'
- description: ''
is_valid: true
key: STARTDURATION
value: '5'
- description: ''
is_valid: true
key: FROMTIME_DAILY_DURATION
value: '6'
- description: ''
is_valid: true
key: STARTEND_DAILY_DURATION
value: '7'
key_format: string
strict: true
use_part: false
validate_only: false
value_format: int32
x-open-field-id: 3
start_date:
description: ''
format: date
# --- truncated at 32 KB (237 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/tiktok-ads/refs/heads/main/openapi/tiktok-ads-campaign-creation-api-openapi.yml