Python SDK

import os
from usgm import Usgm
usgm = Usgm(token=os.environ["USGM_API_KEY"])  # never hard-code the key

# Your account profile
account = usgm.account.get()
print(account.email, account.status)
# List mail, one page at a time (cursor pagination)
cursor = None
while True:
    page = usgm.mails.list(cursor=cursor)
    for mail in page.data:
        print(mail.id, mail.sender_name)
    cursor = page.next_cursor
    if cursor is None:
        break
# Fetch one item
mail = usgm.mails.get(id="80421")
# Create a folder
folder = usgm.folders.create(name="Taxes")

import asyncio
from usgm import AsyncUsgm
usgm = AsyncUsgm(token=os.environ["USGM_API_KEY"])
async def main():
    page = await usgm.mails.list()
    for mail in page.data:
        print(mail.id)
asyncio.run(main())

from usgm.core.api_error import ApiError
try:
    usgm.mails.get(id="does-not-exist")
except ApiError as err:
    # `body` is the RFC 9457 problem+json payload (code, request_id, detail, …)
    print(err.status_code, err.body)
    raise