Skip to main content
TikTok for Developers

Docs

Add a Sandbox

Sandbox mode is a restricted environment that allows you to try out integrations without having to submit your app for review. You can create multiple sandboxes for your app to experiment with different configurations without compromising the live version of your app. You can create up to 5 sandboxes.

Prerequisites

Before registering your app, do the following:

  1. Create a TikTok developer account from our signup page using your email.
  2. Create or join an organization representing the owning group of the app. This step is highly recommended but not required.

You will also need access to a URL decoder to authorize target users.

Create a Sandbox

This workflow demonstrates how to create your first sandbox.

  1. Go to the Manage apps page, then select an app or Connect an app if you don't have one yet.
  2. On the app page, switch the toggle next to your app's name to Sandbox.
  1. Click the Create Sandbox button, then enter a name. You can choose to clone an existing configuration from your app's production versions or another sandbox.
  1. Click Confirm to create the sandbox.
  2. Configure the sandbox as desired by editing App details and adding products.

Note: Sandbox mode does not offer access to Content Posting API for public videos or Data Portability API.

  1. Click Apply changes to save changes and make your configuration take effect.

To create another sandbox, click the [+] button (Create Sandbox) in the left navigation panel.

Manage target users

Adding target users to a sandbox allows them to try out your sandbox configurations. To add a TikTok account that you own as a target user, you must provide its login credentials. You can add up to 10 accounts.

  1. Go to Sandbox settings on the app page.
  2. Under Target users, click Add account. You will be redirected to log in to a TikTok account.
  3. Log in to the TikTok account and agree to the TikTok Developer Terms of Service.

Your target users will be displayed on your app page after they have been added. Results may take up to an hour to show after you refresh the page.

Authorize target users with Login Kit

After you add target users, you may authorize them if you want to use Login Kit and the other products dependent on it. Authorization workflows for Web, Desktop, iOS, and Android are available in the Login Kit documentation.

Import your Sandbox configuration

You can import a sandbox's configuration to a Draft of your app in production. Doing so will overwrite the draft's existing configuration with the chosen sandbox configuration.

Note: You can only import a sandbox configuration to a Draft in Production mode.

  1. On the app page, switch the toggle next to your app's name to Production.
  2. Click Draft in the left navigation panel.
  3. Click Import, then select the sandbox you want to import from.

If you have a version of the app that has been approved and is live, you can revert back to that configuration by clicking Revert to Live version in the Import dropdown.

When you are ready to submit your app, make sure that it follows our app review guidelines.

For further inquiries or assistance, contact us through our Support form.


TikTok for Developers