> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# agent-cards credentials

> Copy your company's sandbox or production client ID and secret.

Get the client ID and secret your app uses to call Agentcard, as the two lines your env file needs. The dashboard's Credentials page shows the same pair.

```bash theme={null}
agent-cards credentials --help
```

```text theme={null}
Usage: agent-cards credentials [options]

Your company's sandbox or production client ID and secret, copied to your
clipboard

Options:
  --mode <mode>        sandbox or production (asked when left out)
  --company <company>  The company id or name, when your account belongs to
                       more than one
  --yes                Create production credentials without asking, when there
                       are none yet
  -h, --help           display help for command
```

## Copy your sandbox credentials

```bash theme={null}
agent-cards credentials --mode sandbox
```

```text theme={null}
  Agentcard  credentials

  AGENTCARD_CLIENT_ID=24faba58-6c1e-4f0a-9d2b-7e3c51a0b8f4
  AGENTCARD_CLIENT_SECRET=acs_Xq3vT9mPa1LkR7sWc2NdF8hJ0yBz4uEo6iGn5tKv

  ✓ Copied to your clipboard, ready to paste into your .env
```

Paste the lines into your app's env file. Leave out `--mode` and the CLI asks which credentials you want:

```text theme={null}
  ? Which credentials?
    ● Sandbox     stops before payment, for building and testing
    ○ Production  places real orders on real cards
    ↑↓ to move, enter to choose
```

Sandbox credentials stop before payment, so build and test with them.

Your company gets sandbox credentials the first time you ask for them, as the dashboard does. When your account belongs to more than one company, the CLI asks which one, or you name it with `--company`:

```bash theme={null}
agent-cards credentials --mode sandbox --company Acme
```

An account with no company yet gets one here. In a terminal the CLI asks its name, with your work email's domain offered. Without a terminal, `--company "Acme"` names it. You become the new company's owner.

## Get production credentials

```bash theme={null}
agent-cards credentials --mode production
```

Production credentials place real orders and charge real cards. When your company has none yet, the CLI asks before it creates them, with no as the answer when you press Enter. `--yes` creates them without asking. Your company needs an active subscription to create them; without one the CLI points you to Billing in the dashboard.

Only owners and admins can see the secret. Anyone else gets the client ID alone and a note to ask an owner or admin.

## Print them for a script

Without a terminal, the CLI prints the two lines and copies nothing:

```bash theme={null}
agent-cards credentials --mode sandbox >> .env.local
```

Without a terminal `--mode` is required, and production credentials that do not exist yet need `--yes`:

```text theme={null}
Error: Name the credentials with --mode sandbox or --mode production.
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.