Skip to main content

Adding and editing credentials

Add credentials in workspace settings when an automation or API agent needs access to an external account, API, desktop connection, proxy, or authentication code.

Written by Sam B.

Important: All credentials are securely stored in 1Password (or Nango, for API connections) and are never revealed to our partners. Never hardcode usernames, passwords, API keys, or OTP values into instructions.

Agents need their own provisioned identity and scoped permissions — not borrowed human credentials — for optimal security and reliability.

Open Workspace Authentication

  1. Open Workspace settings.

  2. Select Authentication.

  3. Review the authentication table.

Add A New Authentication

  1. Click Add.

  2. Fill in the required fields. See below for guidance!

  3. Complete any external connection flow if one opens.

  4. Click Add.

  5. Confirm the new authentication appears in the Authentication table.

Type

  • Single – You have credentials for one account only.

  • Pool – You have credentials for multiple accounts. Magical will distribute them automatically at runtime, allowing more runs to execute concurrently.

    • Use the Concurrency field to set the exact number of concurrent logins allowed by the website/platform. Leave blank if you're unsure, you can always adjust later!

Group

  • Yes – Your agent needs multiple credentials together to access one site (e.g., a username/password and a phone authentication code).

Credentials supported

  1. Cookie

  2. 1Password

  3. Phone Auth Code

  4. Email Auth Code

  5. API connection

  6. Desktop connection

  7. Native App connection

  8. Remote Desktop Gateway

  9. Proxy server

Edit An Existing Authentication

  1. Open Workspace settings.

  2. Select Authentication.

  3. Click the authentication row you want to update.

  4. In Edit authentication, update the fields that need to change.

  5. Click Save.

  6. Confirm the Updated on value changes in the table.

Delete An Authentication

  1. Open the authentication row.

  2. Click Delete.

  3. Confirm only when the authentication should no longer be available to workflows.

Important Boundaries

  • Credentials are workspace-level resources. After creating one, return to the automation or API agent and select it where needed.

  • Deleting a credential can break automations or API agents that rely on it.

Related Articles
Browser agent credentials & authentication
Did this answer your question?