Creating credentials
- In the dashboard sidebar, open Credentials.
- Pick a credential type (browser login, OTP inbox, or custom integration).
- Provide the username/password or token payload once. Komos encrypts the material at rest.
- Optionally add environment-specific metadata (for example, region or tenant IDs) so builders know when to use the credential.
Email OTP inbox
Enable Email OTP when a site delivers login codes by email. Komos generates a dedicated inbox address for the credential. Forward the OTP emails from your primary mailbox to that address so automations can retrieve them during login. Tips:- Forward only the OTP emails (use sender or subject filters in your email rules).
- OTPs expire after 5 minutes by default; delivery can take 1-2 minutes.
- Some providers require a forwarding confirmation email. Use the Get verification code button to copy the code or open the confirmation link.
- If you update the credential, confirm the OTP address shown in the Credentials list.
Connecting credentials to tasks
- In the task builder, choose Credentials and select the saved record before publishing.
- When a credential is attached, Komos signs in with it first, then executes the recorded actions.
- The credential configuration can include MFA or OTP flows; Komos prompts the runner with any additional steps needed to complete authentication.
- Reuse the same credential across multiple tasks when they share the same login.
- The Login node supports an optional
instructionsfield for natural language guidance the login agent should follow (e.g., “Click the SSO button instead of typing the password”).
Rotating or revoking
- Update the secret value from the Credentials screen to rotate it. New runs pick up the refreshed value immediately.
- Disable a credential to block future runs that depend on it. Existing runs fail fast with
credential_unavailableso operators know to intervene.