Etsy API Connection

Etsy API Connection

A valid Etsy API connection gives Next-Cart the authorized platform access required by the selected migration path.

Next-Cart may ask for Etsy application credentials, such as an API Key and API Secret. Prepare the credentials from the Etsy Developer portal, then enter the requested values in Next-Cart.

Use secure credential handling

Etsy application credentials are sensitive. Store them securely and do not share them through unprotected messages or documents.

When to use this guide

Use this guide when:

• Etsy is the Source Platform or Target Platform in your selected migration path;
• Next-Cart shows Etsy API setup;
• you can access the Etsy account and developer area needed to create or view API credentials.

Prerequisites

Before you begin, confirm that:

Requirement	Why it matters
Etsy account access	You need access to the Etsy account connected to the shop data.
Etsy Developer portal access	API credentials are created or viewed from the developer portal.
Developer terms accepted	Etsy may require developer terms before app credentials are available.
Required app details	Etsy may require an app name, description, and website details.
Secure storage	API credentials should be copied and stored safely.

Required values

Required value	Where to prepare it	Notes
API Key	Etsy Developer portal	Etsy may label this as a key string or app key.
API Secret	Etsy Developer portal	Etsy may label this as a shared secret or client secret.

Prepare Etsy API credentials

1. Sign in to the Etsy account connected to the shop data.
2. Open the Etsy Developer portal.
3. Accept developer terms if prompted.
4. Create a new app, or open the app created for this migration service.
5. Enter the required app details, such as app name, description, and website details.
6. Select the type and usage options that match seller access or shop-data access where required.
7. Save the app.
8. Open the app details.
9. Copy the API Key.
10. Copy the API Secret.
11. Store both values securely.

Enter the values in Next-Cart

In the Next-Cart connection setup screen for Etsy, enter the values requested by the interface.

Next-Cart field	Etsy value
API Key	API Key or key string from the Etsy app.
API Secret	API Secret or shared secret from the Etsy app.

Expected result

The Etsy API credentials are ready to test in Next-Cart.

Verify the connection

Check	Pass condition
Credential pair	The API Key and API Secret come from the same Etsy app.
Shop match	The Etsy account and app belong to the intended shop context.
Authorization	Any required Etsy authorization completes successfully.
Data access	Next-Cart can access supported Etsy data for the selected migration scope.

If the connection fails

Issue	What to check
API Key rejected	Re-copy the API Key from the Etsy app details.
API Secret rejected	Re-copy the API Secret from the same Etsy app.
Wrong app	Confirm the API Key and API Secret belong to the app created for this setup.
Authorization blocked	Confirm the Etsy account has permission to authorize access to the shop data.
Scope or data access issue	Review the app settings and confirm the requested data is available through the connected Etsy account.

Security cleanup

After migration work is complete and verified:

• revoke or remove the Etsy app if it is no longer needed;
• rotate any exposed secret;
• remove copied credentials from shared notes, tickets, or local files that are no longer needed.

Next step

Goal	Go to
Test the connection	Verify Platform Connections
Fix an API credential issue	Troubleshoot Connection Setup
Continue after the connection passes	Configure Your Migration