Skip to main content
Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

Overview

Notte Personas provide automated identity management for AI agents, enabling them to create accounts, handle two-factor authentication, and interact with web platforms without manual intervention. Notte Personas come with complete digital identities:
  • Unique Email Address: Dedicated mailbox for each persona with full email management
  • Phone Number: SMS-capable phone number for verification and 2FA
  • Credential Vault: Optional secure storage for passwords and authentication tokens
  • Automated Communication: Built-in email and SMS reading capabilities
  • 2FA Support: Seamless handling of two-factor authentication flows

Persona Attributes

How it works

persona-workflow A persona is a complete digital identity for your automations. When a session needs to create an account or authenticate with a service, it uses the persona’s details, inbox, and phone number to complete the flow. The persona system integrates with both the browser session and the secure vault, so your automation can:
  1. Fill registration forms with persona details
  2. Receive and read verification emails
  3. Handle SMS-based 2FA codes
  4. Store generated passwords and tokens securely
Your automation can complete sign-up and login flows without waiting for a human to forward a code.

Persona Management

Python SDK

The following snippet shows how to create and manage personas using the Notte Python SDK.
⚠️ You need to have an active Notte account to create personas. Each persona incurs additional charges for the email and phone services.
personas.py

Choosing an email provider

Each persona gets an inbox from an email provider, chosen with email_provider when you create it:
agentmail_persona.py
With the REST API, pass email_provider to POST /personas/create. Persona responses include the email_provider field.
Only the inbox backend and the email address change. Everything else works the same way with either provider:
  • Read emails with persona.emails() or GET /personas/{persona_id}/emails.
  • Vaults, credentials and phone numbers are unaffected.
  • Deleting the persona also deletes its AgentMail inbox.
AgentMail and Resend inboxes are receive-only: personas cannot send email. See the AgentMail integration guide for a full sign-up example.

Use Cases

Account Creation Workflows

Personas excel at automating account registration across multiple platforms:
  • SaaS Signups: Automatically create accounts on software platforms
  • E-commerce: Register for shopping sites and marketplaces
  • Social Media: Set up profiles across social networks
  • Financial Services: Complete KYC and account opening processes
  • QA Testing: Generate test accounts for quality assurance

Security & Privacy

  • 🔒 Each persona operates in complete isolation
  • 🔒 Communication channels are encrypted and secure
  • 🔒 Optional integration with Notte’s secure vault system
  • 🔒 Automatic cleanup and data retention policies
  • 🔒 Full audit trail of persona activities
Personas are designed to work seamlessly with Notte’s existing vault system. You can create a persona with an associated vault to store any credentials generated during account creation, ensuring they’re available for future sessions.
Personas should be used responsibly and in compliance with the terms of service of the platforms your agents interact with. Ensure your use cases align with platform policies and applicable regulations.