Generate Etsy API Credentials and Connect Account

This guide explains how to set up Etsy API credentials from the Etsy Developer Portal and connect your Etsy account to Odoo.

Step 1: Create An Etsy Developer Account

  1. Go to the Etsy Developers Portal.

  2. Sign in with your Etsy account.

  3. Register as a developer to access the Manage your apps dashboard.

Step 2: Create An Application

  1. From the Manage your apps dashboard, click on Create a New App.

  2. Enter an App Name (e.g., Odoo Etsy Integration) and complete the requested details.

  3. Submit the form to create the application.

    After creation, your application provides two keys:

    • Keystring (API Key / Client ID): Used to identify your application.

    • Shared Secret (Client Secret): Used for OAuth token exchange.

  4. In your Odoo instance, open the Credentials tab of your Etsy instance and fill in:

    • Etsy Client ID: Paste the Keystring from the Etsy Developer Portal.

    • Etsy Client Secret: Paste the Shared Secret from the Etsy Developer Portal.

    Etsy instance credentials tab with Client ID and Client Secret fields

Step 3: Configure The OAuth Callback URL

Before you can connect your Etsy account, you need to register the OAuth callback URL on your Etsy app.

  1. In your Odoo instance, on the Credentials tab, copy the OAuth Callback URL shown on the instance form. It is auto-generated from your Odoo base URL.

    Etsy instance OAuth Callback URL field with copy button

  2. Go back to the Etsy Developer Portal and open your application via Manage your apps –> Edit.

  3. Under Callback URLs, paste the OAuth Callback URL copied from Odoo as the Redirect URI.

  4. Click Save.

Warning

The OAuth Callback URL must match exactly and be a publicly accessible URL. If your Odoo instance is behind a firewall or uses a local domain, Etsy will not be able to redirect back after authentication.

Important

Both credential fields (Etsy Client ID and Etsy Client Secret) are required. The Connect Etsy Account button will not work without them.

Step 4: Connect Etsy Account

  1. On your Etsy instance in Odoo, click the Connect Etsy Account button.

    Etsy instance with Connect Etsy Account button

  2. You will be redirected to the Etsy login and consent page (the connection uses the secure OAuth 2.0 with PKCE flow).

  3. Log in with your Etsy seller account.

  4. Review the requested permissions (read and write access to your listings, orders, and shop) and grant access.

  5. After granting access, you will be redirected back to your Odoo instance.

  6. The access token and refresh token are generated and stored securely on your Odoo instance, and your Shop Id and Shop Name are fetched automatically from Etsy.

Step 5: Test The Connection

  1. Click Test Connection in your Odoo instance.

    Etsy instance with Test Connection button

  2. If the configuration is correct, a success message will appear confirming the connection.

    Etsy Test Connection success message

  3. You can now proceed with the instance configuration and confirmation.

Note

  • The Etsy refresh token expires after 90 days. When it is about to expire (within 30 days), the connector creates a reminder activity on the instance. If the refresh token expires, the instance is reset to draft and you must reconnect your Etsy account by clicking the Connect Etsy Account button again.

  • Changing the Etsy Client ID or Etsy Client Secret clears the stored tokens, so you must reconnect the Etsy account.

  • After testing the connection, you can configure and confirm the instance.

See also