> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Easyship OAuth 2.0 connector profile – StackOne setup guide

> Set up a connector profile using OAuth 2.0 for Easyship in StackOne to allow users to link their accounts.

> [!WARNING]
>
> Easyship does not offer self-service OAuth client registration. You must request a client from an Easyship representative before this auth method can be used.

## Request an OAuth client from Easyship

Easyship issues partner OAuth clients manually. Contact your Easyship account manager or [Easyship support](https://support.easyship.com/hc/en-us) and provide the details below.

**1. Send Easyship your app details**

Easyship needs the following before it can issue credentials.

<ul>
  <li>**Callback URL** - supply `https://api.stackone.com/connect/oauth2/easyship/callback`. Easyship only accepts a redirect that was pre-registered on the client.</li>
  <li>**Logo** - an image for your platform, shown on the Easyship consent screen.</li>
  <li>**Scopes** - the list of scopes the app is permitted to request. Request every scope in the Scopes field below so all connector actions work.</li>
</ul>

**2. Store the issued credentials**

Easyship returns a Client ID and a Client Secret, plus the set of scopes the client is permitted to request.

<ul>
  <li>Enter the **Client ID** and **Client Secret** in the fields below.</li>
  <li>Keep the Client Secret confidential - it authenticates your platform, not an individual merchant.</li>
</ul>

**3. Match the requested scopes to the client**

The **Scopes** field defaults to every scope the connector's actions use. Requesting a scope that Easyship did not grant your client causes the authorization request to fail.

<ul>
  <li>If Easyship granted a narrower set, replace the default with exactly the scopes your client holds.</li>
  <li>Easyship has two scope formats - legacy (2023-01 and older) and the `public.<resource>:<action>` format used here (2024-09 and newer). A client cannot mix both, so ask Easyship for a 2024-09 client.</li>
</ul>

## Create the StackOne Connector Profile

**1. Create a Connector Profile**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

**2. Link an Account**

Once the Connector Profile is created, continue to [link an account](https://docs.stackone.com/connectors/easyship/guides/link-account/oauth-2-0.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.