Skip to main content
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 and provide the details below.

1

Send Easyship your app details

Easyship needs the following before it can issue credentials.

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

  • Enter the Client ID and Client Secret in the fields below.
  • Keep the Client Secret confidential - it authenticates your platform, not an individual merchant.
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.

  • If Easyship granted a narrower set, replace the default with exactly the scopes your client holds.
  • 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.

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.
2

Link an Account

Once the Connector Profile is created, continue to link an account.