advertiser_update

Business address shown on receipts. Length: 1-1,024 characters.

Required when `bc_id` is passed. Budget settings for one or more ad accounts. Maximum size: 50 when `budget_update_type` is `UPDATE` or `RESET`; 1 when `budget_update_type` is `INCREMENTAL_UPDATE` or `ONE_CLICK_SET`. Each ad account's monthly, daily, and custom budget can be updated up to 20 times per calendar day.

Either `advertiser_id` or `bc_id` must be set. Use `advertiser_id` to update non-budget settings for a single ad account. Do not use this top-level field for budget updates of one or more accounts; for those, pass `bc_id` and provide each account's `advertiser_id` inside `advertiser_budgets`. Ad account ID.

New ad account name.

Either `advertiser_id` or `bc_id` must be set. Use `bc_id` to update the budget for one or more ad accounts. Only ad accounts under the specified `bc_id` can be updated. Only users with Finance Manager permission (`finance_role` is `MANAGER`) can update account budgets and reset budget consumption.

Type of budget change. Valid only when `bc_id` is passed and not supported when top-level `advertiser_id` is passed. Enum values: `UPDATE` updates budget mode and budget amount; when set to `UPDATE`, provide `advertiser_id` in each `advertiser_budgets` item, provide `budget`, and optionally `budget_mode`. `RESET` resets budget consumption to 0; only ad accounts with `budget_mode=CUSTOM_BUDGET` can be reset, and when set to `RESET`, only `advertiser_id` inside `advertiser_budgets` is required while `budget_mode` and `budget`, if passed, are ignored. `INCREMENTAL_UPDATE` adds to or deducts from the current ad account budget; when used, `request_id` is valid and should be passed for idempotency, and `budget_mode` in `advertiser_budgets` is not supported. `ONE_CLICK_SET` sets the ad account budget to the minimum amount; you do not need to specify `budget` in `advertiser_budgets`. Default: `UPDATE`. `UPDATE` and `RESET` are supported only for Auction ad accounts.

Company name. Before updating this field, call `/advertiser/info/` with `fields` set to `["company_name_editable"]`. If `company_name_editable` is `true`, you can update the company name through this field; if `false`, you must contact your TikTok representative. If you update this field, set `need_submit_certificate=true` to submit the new certificate information for review.

Contact email.

Name of the contact person.

Contact phone number.

Image ID (`image_id`) of the business license. If you update this field, set `need_submit_certificate=true` to submit the new certificate information for review.

Business license number. Supported only for ad accounts registered in mainland China, Hong Kong, Brazil, or Mexico. If you update this field, set `need_submit_certificate=true` to submit the new certificate information for review.

Whether to submit updated certificate images/information for review. Supported values: `true`, `false`. Set this field to `true` only when you update any of these fields: `company`, `promotion_link`, `license_no`, `license_image_id`, or `qualification_images`. If none of those fields change, omit this parameter to avoid re-triggering the certificate review process.

Promotion link. Maximum length: 255 characters. If you update this field, set `need_submit_certificate=true` to submit the new certificate information for review.

Additional business certificates. If you update this field, set `need_submit_certificate=true` to submit the new certificate information for review.

Valid only when `budget_update_type` is `INCREMENTAL_UPDATE`. Client-supplied idempotency key used to prevent submitting the same incremental budget update twice; if you retry with the same request ID, only one request will succeed. This is different from the response `request_id`, which identifies the HTTP request. The value should be a 32-bit string, and idempotency is guaranteed for a 30-minute window. This is an allowlist-only feature for incremental ad account budget updates.

Billing and invoicing tax numbers. The accepted keys depend on country; for example, France uses `vat` and Brazil uses `tax_id`.