Create a note

• Performance tracking: Add notes to emails with performance metrics or observations
• Subscriber management: Document important information about specific subscribers
• Content planning: Leave notes on emails for future reference or follow-up
• Team collaboration: Share context and insights with other team members
• Data annotation: Add structured metadata for reporting or analysis

• List notes - Retrieve existing notes
• Notes introduction - Learn more about the notes system

Sample requests

These sample requests are autogenerated by the OpenAPI spec.

import requests

url = "https://api.buttondown.com/v1/notes"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}

response = requests.request("POST", url, headers=headers)
print(response.text)

Sample responses

The IDs and values referenced in these responses are fake; please only rely on these responses for overall structure.

{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "creation_date": "2000-01-01T00:00:00+00:00",
    "body": "This person rocks :)",
    "model_type": "subscriber",
    "model_id": "13121cd6-0dfc-424c-bb12-988b0a32fcb3",
    "metadata": {},
    "user_id": "cd4db23f-052d-425a-8e5b-73e51c1c9b85",
    "user": null
}

Body parameters

All parameters are optional unless explicitly specified.