Persona Emails List

GET /personas/{persona_id}/emails

python

Python

import datetime as dt

from notte_sdk.client import NotteClient

notte = NotteClient()
# retrieve an existing persona or use console.notte.cc/personas to create a new one
persona = notte.Persona("<my-persona-id>")
# read recent emails (received in the past 5 minutes)
recent_emails = persona.emails(
    only_unread=True,
    limit=10,
    timedelta=dt.timedelta(minutes=5),
)
print(f"Recent emails: {recent_emails}")

200

[
  {
    "subject": "<string>",
    "email_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "sender_email": "<string>",
    "sender_name": "<string>",
    "text_content": "<string>",
    "html_content": "<string>"
  }
]

Authorizations

Authorization · string · header · required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

x-notte-request-origin · string | null

x-notte-sdk-version · string | null

Path Parameters

persona_id · string · required

Query Parameters

limit · integer · default: 10

Maximum number of emails

Required range: 1 <= x <= 100

timedelta · string<duration> | null

Maximum time since email reception

only_unread · boolean · default: false

Whether to only return unread messages

Response

200

application/json

Successful Response

subject · string · required

Subject of the email

email_id · string · required

Email UUID

created_at · string<date-time> · required

Creation date

sender_email · string | null · required

Email address of the sender

sender_name · string | null · required

Name (if available) of the sender

text_content · string | null

Raw textual body, can be uncorrelated with html content

html_content · string | null

HTML body, can be uncorrelated with raw content