Create a Live API key
The key that moves real money, once your workspace is activated for Live.
Sandbox: test money only. No request moves real money.
In this step you create the key that moves real money. It exists only for a workspace activated for Live; see Complete Live activation.
Create it
Live keys start with nbk_live_ and work only on the Live host. You create one in your dashboard, under Developers, API keys, once your workspace is active on Live. In Live only an Owner or an Admin creates a key, after a sign-in within the last 5 minutes. Like a sandbox key, it is shown once.
Choose its scopes: there is no default, and a key never holds one your role lacks. Your first Live order lists the six a first order uses.
Keep it apart from your test key
Keep the key on your server, in your secret manager or the NASFAM_LIVE_KEY environment variable, and the sandbox key in NASFAM_SANDBOX_KEY, so a test run can never reach the live balance. Never put either in browser JavaScript or an app. A key never works on the other environment's host.
The same code runs against both environments: change the base URL and the key, nothing else. Create and manage API keys covers rotation and revocation.
What you should see
GET /account with the new key answers with an environment of live and a kyb_status of active:
{ "id": "org_ 01K7SAMP000000000000000090", "name": "Example Business Ltd", "environment": "live", "kyb_ status": "active", "limits": { "max_ queued": 50 }}If it fails
| What you see | What to check |
|---|---|
| You cannot create a live key | Your workspace is not active on Live, or your role is not Owner or Admin. Your dashboard says what is left; see Complete Live activation. |
key_environment_mismatch | The key and the host belong to different environments. Each key works on its own host only. |
| The dashboard asks you to sign in again | Your sign-in is older than 5 minutes. Sign in again, then create the key. |
| You did not copy the key when it was shown | It cannot be shown again. Revoke it in the dashboard and create another. |
Next step
Live step 4 of 5: Send real orders. The same code, the Live host and your Live key. A first read proves them, then the checklist, then your first real order.
Related concepts
- Create and manage API keys: rotation, revocation and what a key may do.
- Authentication and keys: the key format.
