Connecting eBay with OttoKit

Overview

To connect your eBay account with OttoKit, you need to create an application in the eBay Developer Program. This gives you three things OttoKit needs to authorize requests on behalf of your eBay account:

• Client ID (called “App ID” in eBay’s portal)
• Client Secret (called “Cert ID” in eBay’s portal)
• RuName (eBay’s unique identifier for your redirect URL)

This guide walks you through the full setup, end to end. Plan around 10 to 15 minutes.

Before you start

Have these ready:

• An eBay account in good standing (ideally the one that owns your seller activity)
• Access to the email address linked to that eBay account
• A privacy policy URL for your business or website

Step 1: Create an eBay Developer Account

1. Open the eBay Developer Program signup page: https://developer.ebay.com/signin

2. Click Register if you do not already have a developer account.
3. Sign in with your existing eBay account credentials. If you do not have one, create a new eBay account first.
4. Accept the eBay API License Agreement.
5. Verify your email address using the link eBay sends you.

Tip: Use the same eBay account that owns the listings, inventory, or orders you want to automate.

Step 2: Create Your Application Keyset

Application keys are the credentials that identify your app to eBay. Every developer account gets two separate keysets: Sandbox (for testing) and Production (for real data).

6. Once signed in, go to My Account then Application Keysets. Direct link: https://developer.ebay.com/my/keys
7. If you do not see a Production keyset, click Create a keyset under the Production column.

8. Fill in the requested details about your application. eBay may ask for the application name, description, and intended use.
9. Submit the form. eBay will generate your Production keyset immediately.

Important: You can also create sandbox keys for testing. The Sandbox keyset only works against eBay’s test environment and will not see your real listings or orders.

Step 3: Copy Your Client ID and Client Secret

On the Application Keysets page, find the Production row. You will see several fields. Here is how they map to OttoKit:

eBay field name	What it maps to in OttoKit
App ID (Client ID)	Client ID
Cert ID (Client Secret)	Client Secret
Dev ID	Not required for OAuth, keep for reference
RuName	You will create this in Step 4

10. Copy your App ID from the Production row.
11. Click the eye icon next to Cert ID to reveal it, then copy it.
12. Store both values somewhere safe. You will paste them into OttoKit at the end.

Important: The Cert ID acts like a password. Do not share it publicly, post it in screenshots, or commit it to source code.

Step 4: Create Your RuName

What is a RuName?

Most OAuth providers accept a redirect URL directly. eBay does not. Instead, you register your redirect URL on eBay’s side, and eBay generates a unique identifier for it called a RuName (short for Redirect URL Name). You then pass this RuName, not the URL itself, when OttoKit authorizes against eBay.

A RuName looks like this:

Brainstorm_Force-OttoKit-PRD-abc12345-xxxxxx

Create the RuName

13. On the Application Keysets page, find your Production keyset row.
14. Click the User Tokens link on that row.

15. On the User Tokens page, select the Get a Token from eBay via Your Application option (the OAuth flow, not Auth’n’Auth).
16. Click Add eBay Redirect URL.
17. Fill in the form with these exact values:

Field	Value to enter
Display Title	OttoKit (or any name you prefer; this is shown to you, not to end users)
Your Privacy Policy URL	Can be skipped
Your auth accepted URL	https://api.ottokit.com/ebay/connection
Your auth declined URL	https://api.ottokit.com/ebay/connection (the same URL is fine)

The auth accepted URL must be exactly:

https://api.ottokit.com/ebay/connection

Copy and paste this value. A single missing character or extra slash will cause the OAuth flow to fail.

18. Click Save.
19. eBay generates a RuName string. Copy this value.

Note: The RuName is what OttoKit needs, not the URL. The URL is only used internally by eBay to know where to send users after they consent.

Step 5: Connect eBay to OttoKit

You should now have three values copied:

• App ID (Client ID)
• Cert ID (Client Secret)
• RuName

In OttoKit:

20. Open the eBay connection screen.
21. Paste your App ID into the Client ID field.
22. Paste your Cert ID into the Client Secret field.
23. Paste your RuName into the RuName field.
24. Select your eBay marketplace (for example, EBAY_US, EBAY_GB, EBAY_DE).
25. Select your eBay Environment.
26. Click Connect. You will be redirected to eBay to grant permission, then back to OttoKit.

Once consent is granted, OttoKit stores the access and refresh tokens. The connection is ready to use in your automations.