Skip to main content

​
Retrieve your Windsor.ai API key

Windsor.ai authenticates every request with a single API key that belongs to your Windsor.ai
account. It is always available from your account settings — you can reveal, copy, or reset it at
any time, so there is nothing to create first.

1

Sign in and open Settings

Sign in to the Windsor.ai onboarding app, then click Hello [your email]! in the top-right corner of the header to open the account menu and choose Settings.

  • The account menu also contains Extend trial, refer friends!, Request feature, Partner program, Documentation, What’s new and Sign out — the entry you need is Settings.
The Windsor.ai account menu open in the header with the Settings entry highlighted.
2

Copy your API key

The Settings page opens on the Account tab. In the API Access section at the top, the API key: field holds your key, masked by default. Click the eye icon to reveal it, or click the copy icon beside it to copy the value straight to your clipboard.

  • This is the value for the API Key field in StackOne Hub — the single credential that authenticates every Windsor.ai request.
  • Treat the key like a password. It is not tied to a single machine, so anyone holding it can read your Windsor.ai data.
  • The third icon resets the key. Resetting issues a new key and immediately invalidates the old one, which breaks any existing connection still using it.
The Settings page on the Account tab, with the API Access section showing the masked API key field and its reveal and copy buttons highlighted.

​
Optional — enable write actions

Read-only actions work as soon as the key is connected. Actions that change something on a
connected platform — such as pausing a campaign or setting a budget — are turned off by default
and must be enabled before they will run.

1

Turn on write actions

In the same API Access section, switch on Enable write actions for Claude, ChatGPT & API. Windsor.ai describes it as Lets AI assistants like Claude and ChatGPT (and the API) make changes in your connected platforms, such as pausing campaigns or setting budgets.

  • The setting applies only to your own user, not to the rest of your team — each member enables it separately.
  • Leave it off if you only need to read reporting data. With it off, write requests are rejected with an authorization error.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • API Key
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.