tto_tcm_campaign_create

List of ad account IDs to associate with the campaign. When a creator's video is linked to the campaign, these ad accounts are automatically granted Spark Ads authorization for the video. For `CAMPAIGN` campaigns, the video is also automatically synced to the creative library of these ad accounts. When `advertiser_ids` is specified, `default_spark_ads_requested_authorization_days` is required. Maximum 50 IDs. For `BRAND_LINK` campaigns, you can specify ad accounts that share the same business center, legal entity, or logged-in email.

ID of the anchor to associate with the campaign. The anchor is visible only to audiences in the anchor's target country. Anchor performance can be measured only when the creator's country matches the anchor's target country; the video remains visible to the creator's audience, but the attached anchor is shown only in the anchor's country.

Brand name. For campaign-level invite-link creation, either `brand_profile_id` or `brand_name` is required. Length limit: 60 characters. If `campaign_id` is provided to update an existing campaign, the current campaign `brand_name` is used regardless of the value passed here.

ID of a Brand Profile within the TTO Creator Marketplace account to associate with the campaign. Required when `campaign_type=BRAND_LINK`. For campaign-level invite-link creation, either `brand_profile_id` or `brand_name` is required.

Handle (username) of the Business Account. When included during campaign creation, creators can choose to message the brand directly when they open the generated invite link. Applicable only when the handle is a non-EU Business Account. This is currently an allowlist-only feature.

Campaign description, such as product positioning, target audience, and core features. Length limit: 1,000 characters. If `campaign_id` is provided to update an existing campaign, the current campaign `campaign_description` is used regardless of the value passed here.

ID of an existing TTO Creator Marketplace campaign. Valid only when updating an existing campaign. If this field is provided, all other request fields except `tto_tcm_account_id` and `handle_names` are ignored. When you pass `campaign_id`, you must also pass `handle_names` to add new creators to the existing campaign.

Campaign name. Length limit: 120 characters. If `campaign_id` is provided to update an existing campaign, the current campaign `campaign_name` is used regardless of the value passed here.

Type of TTO Creator Marketplace campaign. If omitted for campaign-level invite-link creation, the default is `CAMPAIGN`. Use `CAMPAIGN` for a campaign-level invite link. Use `BRAND_LINK` for a brand-level invite link; in that mode, `brand_profile_id` is required. For campaign-level invite-link creation, either `brand_profile_id` or `brand_name` is required.

Valid only when creating a new campaign. Required when `advertiser_ids` is specified and optional when `advertiser_ids` is not specified. Ignored when updating an existing campaign with `campaign_id`. Sets the default number of days of Spark Ads authorization to request for all videos uploaded to the campaign. Range: 0-365. Default: 0. Once set to a value other than 0, when a creator accepts the invitation and uploads videos to the campaign, the creator automatically grants Spark Ads authorization for the specified number of days.

List of TikTok creator handles to invite. Maximum 100 handles. For new campaigns, provide the creators to invite. When updating an existing campaign with `campaign_id`, provide additional handles to invite; these are added to the existing list rather than replacing it. When `campaign_id` is passed, you must pass `handle_names` at the same time to add new creators.

Whether to send campaign invitation notifications to the inboxes of creators listed in `handle_names`. Creators can open the notification to join the campaign. Supported values: `true`, `false`. Default: `false`.

The ID of the TTO Creator Marketplace account. To obtain accessible account IDs for the current `Access-Token`, use `/tto/oauth2/tcm/`.