Print and mail API for sending postal letters

python
import requests
​
access_token = "INSERT_YOUR_ACCESS_TOKEN_HERE"
organisation_id = "YOUR_ORGANISATION_UUID"
​
# 1. Request an upload URL
upload = requests.get(
    "https://api.letterapi.uk/file-upload",
    headers={"Authorization": f"Bearer {access_token}"},
).json()["data"]["attributes"]
​
# 2. Upload the file
with open("letter.pdf", "rb") as f:
    requests.put(upload["url"], data=f)
​
# 3. Create the letter
response = requests.post(
    f"https://api.letterapi.uk/organisations/{organisation_id}/letters",
    headers={
        "Authorization": f"Bearer {access_token}",
        "Content-Type": "application/vnd.api+json",
    },
    json={
        "data": {
            "type": "letters",
            "attributes": {
                "file_original_name": "letter.pdf",
                "file_url": upload["url"],
                "file_url_signature": upload["url_signature"],
                "address_position": "left",
                "auto_send": False,
            },
        }
    },
)
​
print(response.status_code, response.json())