Python SDK

1
import os
2
from usgm import Usgm
3
4
usgm = Usgm(api_key=os.environ["USGM_API_KEY"])  # never hard-code the key

1
# List mail (auto-paginates)
2
for mail in usgm.mails.list(is_read=False):
3
    print(mail.id, mail.sender)
4
5
# Fetch one item
6
mail = usgm.mails.get("80421")
7
8
# Mark it read
9
usgm.mails.update("80421", is_read=True)
10
11
# Create a folder and file the mail into it
12
folder = usgm.folders.create(name="Taxes", color="blue")
13
usgm.mails.update("80421", folder_id=folder.id)

1
import asyncio
2
from usgm import AsyncUsgm
3
4
usgm = AsyncUsgm(api_key=os.environ["USGM_API_KEY"])
5
6
async def main():
7
    async for mail in usgm.mails.list(is_read=False):
8
        print(mail.id)
9
10
asyncio.run(main())

1
from usgm import UsgmError
2
3
try:
4
    usgm.mails.get("does-not-exist")
5
except UsgmError as err:
6
    print(err.code, err.status_code, err.request_id)
7
    raise