Buttondown logo

Listing users

Use the /users endpoint to list all of your team members and their permission levels.

Sample requests

These sample requests are autogenerated by the OpenAPI spec.

import requests

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

response = requests.request("GET", 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.

{
    "results": [
        {
            "id": "13121cd6-0dfc-424c-bb12-988b0a32fcb3",
            "email_address": "owner@buttondown.email",
            "permissions": {
                "subscriber": "write",
                "email": "write",
                "sending": "write",
                "styling": "write",
                "administrivia": "write",
                "automations": "write",
                "surveys": "write"
            },
            "status": "owner",
            "last_logged_in": "2020-09-29T12:00:00+00:00"
        }
    ],
    "count": 1
}