v1Resources/Team/getList team members
List team members
Returns your agency's team roster — every user in your agency except the per-agency Synup Bot.
get
team:read/api/v1/team/membersResponse
dataarray of objectoptional
idstringoptional
Unique identifier for the team member.
firstNamestringoptional
The team member's first name.
lastNamestringoptional
The team member's last name.
emailstringoptional
The team member's email address.
rolestringoptional
The team member's role, e.g. "owner" or "member".
invitationStatusstringoptional
The member's invitation state: "invited", "accepted", or null for a member who never went through the invite flow.
lastSessionAtstringoptional
When the member last had an active session, as an ISO 8601 timestamp, or null if never.
createdAtstringoptional
When the team member was created, as an ISO 8601 timestamp.
weeklyHoursCapacitynumberoptional
The member's weekly working-hours capacity, or null if not set.
permissionsobjectoptional
Per-module access flags (dashboard, clients, listings, etc.), or null if never set.
slackUserIdstringoptional
The Slack user ID linked to this member, or null if none.
statusstring (Owner | Invited | Active | Not Active)optional
A computed summary of the member's state: "Owner", "Invited", "Active", or "Not Active" (accepted but no session in the last 7 days).
Errors
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/team/members
Your API key
{
"data": [
{
"id": "cm_user_1",
"firstName": "Jamie",
"lastName": "Rivera",
"email": "jamie@agency.example.com",
"role": "owner",
"invitationStatus": null,
"lastSessionAt": "2026-02-01T14:00:00.000Z",
"createdAt": "2026-01-01T09:00:00.000Z",
"weeklyHoursCapacity": 40,
"permissions": {},
"slackUserId": null,
"status": "Owner"
},
{
"id": "cm_user_2",
"firstName": "Casey",
"lastName": "Nguyen",
"email": "casey@agency.example.com",
"role": "member",
"invitationStatus": "accepted",
"lastSessionAt": "2026-01-30T10:00:00.000Z",
"createdAt": "2026-01-05T09:00:00.000Z",
"weeklyHoursCapacity": 30,
"permissions": {
"posts": true,
"reviews": true
},
"slackUserId": "U12345",
"status": "Active"
}
]
}Guides that use this endpoint
- How to Build a Reputation Management PlatformArchitecture and API calls for a multi-client reputation management platform on Synup: review ingestion, reply workflows, invites, widgets and reporting.
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- How to Build a White-Label Local Marketing PlatformBuild a multi-tenant white-label local marketing platform on the API, with client provisioning, team access, per-client summaries and scoped API keys.