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}")

import { NotteClient } from "notte-sdk";

const notte = new NotteClient();
// retrieve an existing persona or use console.notte.cc/personas to create a new one
const persona = notte.Persona({ persona_id: "<my-persona-id>" });
// read recent emails (received in the past 5 minutes)
const recentEmails = await persona.emails({
  only_unread: true,
  limit: 10,
  timedelta: "5m",
});
console.log("Recent emails:", recentEmails);

curl -X GET "https://api.notte.cc/personas/$persona_id/emails?limit=10&only_unread=true" \
-H "Authorization: Bearer $NOTTE_API_KEY" \
-H "Content-Type: application/json"

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>"
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

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