Use Sandbox to test your integration with Pinterest API v5 without affecting your production data. After successful testing, you can update your code to point your API calls to the production environment.
What you can do in Sandbox
You can make API calls in Sandbox to the following endpoints with a Trial or Standard access tier. You can view boards and Pins you create in Sandbox when you visit your own Pinterest user profile in the Pinterest mobile apps or on Pinterest.com.
Endpoints that appear in the following lists are available in Sandbox.
We structured this list to reflect the left-panel navigation of the API reference.
We check for updates on a quarterly basis (Most recent update: August 12, 2025).
Do not create a Sandbox Pin with a group board. Although the Pin would only be only visible to you, the board owner may receive a notification that a Pin was created, resulting in confusion. Learn more about boards. Do not create a Sandbox Pin with a group board. Although the Pin would only be only visible to you, the board owner may receive a notification that a Pin was created, resulting in confusion. Learn more about boards. Media
Only available in Sandbox.
Visible to you in Sandbox but not live or
visible to Pinterest users.
Business access relationships
Search terms often entered together.
Use Sandbox only for your own ad account, associated entities, Pins and boards.
Also, note that entities in your Sandbox environment are separate from entities in your production environment. For example, you cannot use a Pin in Sandbox to create an ad in production.
You cannot do the following in Sandbox, although some of these capabilities may be supported in the future:
Create video Pins.
Create or manage shopping ads.
Test business access.
Simulate the ads auction, feed status checks, conversion upload, or bulk editing.
If you have not yet set up your app to work with Pinterest, follow the instructions on the app setup page to connect and configure an app. Step 2. Generate a Sandbox access token
To use Sandbox, you need a specific token, which is tied to your Pinterest user account. You cannot use the Sandbox token in your production environment, nor can you use a production token for Sandbox.
Generate a token on your app management page
You can generate a Sandbox token quickly and easily on your app management page. The token lasts 30 days, after which, you could generate a new one if necessary.
Select Manage for the app you want to give Sandbox access.
In the Configure tab, scroll down to the Generate Access Token section.
Select Sandbox as the environment.
Click Generate token.
Copy the generated token, to use in Sandbox API calls.
Generate a token using the OAuth flow
You can also generate a Sandbox token using the OAuth flow. This could be useful if you want to continuously refresh the token for long-term testing in Sandbox. Also, with an OAuth token, you can select specific scopes. When calling you would insert in the URL request path as in the following example: curl -X POST https://api-sandbox.pinterest.com/v5/oauth/token \
Step 3. Start making Sandbox requests
Making API calls in Sandbox is identical to making calls in production, except that the subdomain in the endpoint path is . GET https://api-sandbox.pinterest.com/v5/boards --header 'Content-Type: application/json' --header 'Authorization: Bearer [SANDBOX-TOKEN]'
When you finish testing your integration, do the following to switch from Sandbox to the production environment:
Remove from your endpoint URLs, so that the subdomain is .
GET https://api.pinterest.com/v5/boards --header 'Content-Type: application/json' --header 'Authorization: Bearer [PRODUCTION-TOKEN]'
Use a production token in your API calls. Learn how to generate an access token for all the endpoints you will need to use in production.
Delete any ad accounts you created in Sandbox. Calling the endpoint deletes the ad account and all its child entities, including campaigns, ad groups and ads. Learn how to use the endpoint.
Delete any Pins or boards you created in Sandbox by calling:
Use the endpoint for deleting an ad account
(Only available in Sandbox)
In Sandbox, you can delete an ad account and all associated entities, including ads, ad groups, and campaigns. This endpoint is only available in the Sandbox environment.
DELETE https://api-sandbox.pinterest.com/v5/ad_accounts/{ad_account_id}
204 -- Successfully deleted ad account
Example failure responses
403 -- not authorized to access ad_account
404 -- ad account not found