Connected apps versus API tokens, and what a connected app can do

connected appMCP

There are two ways something other than you can act in your creativehub account: a connected app — an AI app such as Claude or Gemini that you sign in to and allow — and an API token you create for your own scripts. Both appear in the token table on the API / MCP tab of Settings, and both need API / MCP access switched on for the account.

What a connected app is

When you paste the creativehub connection address into an AI app, the app registers itself with creativehub and sends you to the consent page. You sign in with your own creativehub login, see what the app is asking for, and click Allow. The app then holds a short-lived access token for your account and renews it itself; you never see or paste a key, and your password is never given to the app.

The consent page names the app, shows the account you are signed in as, says you can disconnect it at any time from Settings › API / MCP, and names the site you will be returned to.

What it is allowed to do

The consent page lists the permissions as two scopes:

  • See your drops, products, orders, styles and insights (read).
  • Create and change drops, products and styles, and place orders on your behalf (write).

An app granted read only is refused on every change it tries to make — the error says the connection is read-only — so a read-only connection can look but never create, edit, publish or order. Within what it is allowed, a connected app can do exactly what you could do in Sell, on your account only: every request is scoped to your user, so it cannot see another account. Orders it places are charged the same way as orders you place yourself.

Disconnecting

Revoke the app in the token table (Revoke). It stops working within a minute, and the only way back is to connect again — sign in and Allow. Revoking a connected app does not touch your API tokens, and revoking a token does not touch your connected apps.

When to use an API token instead

A token (esch_live_…) is for software you run yourself: a script, a CI job, a website integration. It is a full credential — anyone holding it can act as you — so it is shown once and must be kept secret. A connected app is for an AI assistant you use interactively, where signing in is safer than handling a key. See How to create API tokens for the public /v1 surface.

Whichever way you connect, the print drops page shows the kind of release your app or assistant can help you set up.

Still need a hand?

Ask the in-app help assistant from your creativehub dashboard, or email us — a real person replies. info@creativehub.io