List workspace members

List the members of a workspace with an organisation key: role, status and whether they are guests from another workspace.

GET /v3/organisation/workspaces/{id}/members

Response (200)

json

{
  "items": [
    {
      "id": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
      "name": "Dana Developer",
      "email": "dev@acme-eu.example",
      "role": "developer",
      "initials": "DD",
      "color": "#5b8def",
      "status": "invited",
      "external": false,
      "created_at": "2026-10-29T10:10:00Z",
      "invitation_expires_at": "2026-11-05T10:10:00Z"
    }
  ]
}

Roles are owner, admin, developer, marketer, billing or viewer; status is active, invited or disabled. external is true for guests whose home is another workspace.

Responses

Status	Description
`200`	OK. The members.
`401`	Missing or invalid organisation key — workspace keys (`afn_live_` / `afn_test_`) are refused here by design.
`403`	`insufficient_scope` — the key lacks `members:read` — or `ip_not_allowed`.
`404`	No workspace with this id in your organisation (ids of other organisations are never revealed).

Code examples

cURL

curl https://api.wemail.io/v3/organisation/workspaces/9d2f6c1e-4b3a-4e7d-8a1f-0c5b7e9d2a64/members \
  -H "Authorization: Bearer afn_org_…"

Node.js

const res = await fetch("https://api.wemail.io/v3/organisation/workspaces/9d2f6c1e-4b3a-4e7d-8a1f-0c5b7e9d2a64/members", {
  headers: { Authorization: "Bearer " + process.env.WEMAIL_ORG_KEY },
});
console.log(await res.json());

Python

import os, requests

res = requests.get(
    "https://api.wemail.io/v3/organisation/workspaces/9d2f6c1e-4b3a-4e7d-8a1f-0c5b7e9d2a64/members",
    headers={"Authorization": "Bearer " + os.environ["WEMAIL_ORG_KEY"]},
)
print(res.json())

ResponseExample response

{
  "items": [
    {
      "id": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
      "name": "Dana Developer",
      "email": "dev@acme-eu.example",
      "role": "developer",
      "initials": "DD",
      "color": "#5b8def",
      "status": "invited",
      "external": false,
      "created_at": "2026-10-29T10:10:00Z",
      "invitation_expires_at": "2026-11-05T10:10:00Z"
    }
  ]
}