Persona

​

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

Personas act as complete digital identities that your AI agents can assume during execution. When an agent needs to create an account or authenticate with a service, it uses the persona’s credentials and communication channels to complete the entire flow autonomously.

The persona system integrates with both the browser session and the secure vault, allowing agents to:

1. Fill registration forms with persona details
2. Receive and read verification emails automatically
3. Handle SMS-based 2FA codes
4. Store generated passwords and tokens securely

This creates a seamless experience where agents can navigate complex authentication flows without breaking execution to wait for human intervention.

​

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.

from notte_sdk.client import NotteClient
import datetime as dt

notte = NotteClient()

persona = notte.Persona() 
_ = persona.create(create_vault=True)
print(f"Persona email: {persona.info.email}")

# add a credential to the persona
persona.vault.add_credentials(
    url="https://github.com/",
    email=persona.info.email,
    password="<your-password>",  # pragma: allowlist secret
)

# read recent emails
recent_emails = persona.emails(only_unread=True, limit=10, timedelta=dt.timedelta(minutes=5))
print(f"Recent emails: {recent_emails}")

# get your persona in subsequent scripts
same_persona = notte.Persona(persona_id=persona.info.persona_id)
assert same_persona.info == persona.info

# delete the persona when you don't need it anymore
persona.delete()

​

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