Connect a ShipHero account
Create a new ShipHero connection, save its credentials, and keep its tokens fresh.
An account is one connection to ShipHero. Each account holds its own ShipHero tokens, users, and data. This guide covers creating a connection and keeping it healthy.
NC Super Admins only
Only an NC Super Admin creates or changes a connection. NC Internal Users see Client Connections read-only, and Client Users don't see it. See Roles and access.
Read the connection status
Open Settings → Client Connections. Each account shows one of three states:
- Not Connected (red): a ShipHero token is missing.
- No Credentials (amber): tokens exist, but no saved login.
- Connected (green): tokens and login both exist.
The goal of this flow is to move an account to Connected.
Create a new connection
Only NC Super Admins see the Create New Connection button. It opens a wizard that connects ShipHero, invites the first users, and starts the account. Follow the wizard through to the end. It provisions the account and kicks off its first data pulls.
The first step, Connect ShipHero, takes two tokens created in the brand's ShipHero account. It never asks for the brand's ShipHero email or password.
- In ShipHero, open Users and click + Add Third-Party Developer. A developer user has every permission the connection needs.
- Copy the access token (ShipHero shows it as the Bearer Token) and the Refresh Token. Copy both right away, as ShipHero may not show them again.
- Paste both into the wizard and click Connect.
Connect checks the tokens before you can go on. Tokens an existing connection already uses are refused, and so is an access token ShipHero rejects. The error says which.
New connections show No Credentials
A connection created from tokens has no saved ShipHero login, so it shows No Credentials. Its tokens work, and the weekly token rotation keeps them fresh with the refresh token.
Onboarding runs through N8N
Account creation and the first user invites route through N8N. For the end-to-end steps the automation performs, see New Brand Onboarding. Creating a connection doesn't work on staging, because that automation writes to production.
Manage an existing account
Open an account to manage it:
- Rename the connection.
- Manage credentials to save the ShipHero login and tokens. This is what moves an account from No Credentials to Connected.
- Regenerate tokens to refresh the ShipHero tokens when they expire or need rotating.
- Connect a user to add someone to this account (see Invite and manage users).
- Revoke or re-enable a user's access.
- Delete the connection.
Delete a connection
Delete removes everything
Deleting a connection cascades. It removes the account's orders, shipments, SKUs, purchase orders, and user links, and it cannot be undone. Only delete a connection you are certain should be gone.
Related
- Settings feature guide: the Client Connections screen in context.
- Invite and manage users: add people once the account exists.
- New Brand Onboarding: the automation behind a new connection.