Managing Credentials
Managing your credentials is like keeping the keys on your keyring tidy — you label them clearly, replace the ones that no longer turn, and throw out the ones you don't use anymore. Once you've created credentials, you do all of this from the Credentials page. A credential is the saved sign-in details Nirvai uses to act on your behalf with another service.
Image: The credentials page showing credential cards with edit and delete options
Viewing your credentials
Go to Credentials from the sidebar to see everything you've saved. Each credential card shows:
- Label — the name you gave it
- Type — how it connects (a private code, an access pass, a "Log in with…" sign-in, a username and password, or a Meta connection)
- Service — what it connects to (Google, Slack, and so on)
- Status — whether it's active and working
Editing a credential
- Click the credential card or its edit button.
- Change the fields you need (the label, a private code, a pass, and so on).
- Save your changes.
For "Log in with…" credentials, you can update the label and some settings, but changing the core sign-in details means you'll need to re-connect.
Re-connecting a "Log in with…" credential
These credentials use a secure access pass that renews on its own most of the time. Now and then, the pass lapses and you need to re-connect by hand:
- Go to Credentials.
- Find the credential that needs re-connecting.
- Click Re-authorize (or edit it and click the sign-in button).
- A pop-up opens where you sign in to the service and approve access again.
- Nirvai saves the renewed access for you.
Common reasons you'd need to re-connect:
- The access lapsed (some services end it after a set time)
- You changed your password on the service's side
- You turned off Nirvai's access from the service's settings
- The service changed what permissions it requires
Deleting a credential
- Go to Credentials.
- Find the credential you want to remove.
- Click the delete button.
- Confirm.
Deleting a credential removes it for good and breaks every tool that depends on it. Before deleting, check which agents and tools use it. There is no undo.
Naming a credential
Use clear, descriptive names so you can tell credentials apart at a glance — especially when you have several for the same service.
Good names:
- "Gmail - Marketing Team"
- "Shopify Production Store"
- "HubSpot - Sales Pipeline"
- "OpenAI Text Key"
Avoid:
- "credential_1"
- "test"
- "key"
Troubleshooting
Sign-in problems
| Problem | Fix |
|---|---|
| "Invalid sign-in details" | Double-check the details match exactly what the service shows you — even one extra space or character causes a failure |
| "Permissions not enough" | Edit the credential, add the permissions it asks for, and re-connect |
| The credential won't connect at all | Make sure the sign-in details were copied in full, with no characters cut off |
Access problems
| Problem | Fix |
|---|---|
| "Access expired" | For "Log in with…" credentials, click Re-authorize. For a private code or access pass, get a new one from the service and update the credential |
| "Access turned off" | Re-connect the credential, or get a new code or pass from the service |
| "Too many requests" | The service is slowing you down because of too many requests at once. Wait a bit and try again |
Connection problems
| Problem | Fix |
|---|---|
| Tool calls fail with "Unauthorized" | The credential may have stopped working. Re-connect it, or update the code or pass |
| Tool calls fail with "Forbidden" | You may be missing a permission. Check the credential's permissions or your access on the service |
| The pop-up was blocked when re-connecting | Allow pop-ups from Nirvai in your browser settings |
| A Meta credential isn't working | Re-connect through the Meta credentials flow. Check that your Facebook Page is still active and that you still have admin access |
General tips
- Test after creating or editing — make sure the credential works before your agents rely on it.
- Keep things tidy — use clear labels and delete credentials you no longer use.
- Don't share your private details — if a teammate needs access, they should create their own credential rather than reuse yours.
- Watch for lapses — "Log in with…" credentials renew on their own, but other types can stop quietly. If an agent stops working, check its credentials first.
What's next
To understand how credentials power your agents, revisit Using Credentials with Tools.