Get a key

Before you start

You need a Build account. The Free plan has one account and a sandbox key. Keys come in two kinds: sm_live_… for your connected accounts and sm_test_… for the sandbox.

Create a key

1. Sign in to the console

   Open the console and sign in. A new workspace starts on the Free plan.

2. Connect an account

   Connect Amazon or Google Ads from the console. Skip this step if you only want the sandbox key.

3. Open Keys and name the key

   Name it after what will use it, for example monday-report.

4. Choose what it can reach

   Pick the accounts the key may read, and whether it is read, or read and write. Writes exist on Amazon only.

5. Copy it into your tool's secrets

   Store it as BUILD_API_KEY. Your prompts and code then never contain the key itself.

Use the sandbox key

The console quickstart shows the sandbox key. It is read-only and returns demo data, so you can build before you connect an account.

Keep the key safe

• Keep it in your tool's secrets, never in page code or in a prompt.
• Give each tool or client its own key, so you can revoke one without touching the rest.
• Choose read unless the tool needs to change an Amazon account.

Scopes, revoking and rotation are in Keys and scopes.

Next steps