v1Recursos/Team/getListar membros da equipe
Listar membros da equipe
Retorna a equipe da sua agência — todo usuário na sua agência, exceto o Synup Bot por agência.
get
team:read/api/v1/team/membersResposta
dataarray of objectopcional
idstringopcional
Identificador único do membro da equipe.
firstNamestringopcional
O primeiro nome do membro da equipe.
lastNamestringopcional
O sobrenome do membro da equipe.
emailstringopcional
O endereço de e-mail do membro da equipe.
rolestringopcional
O papel do membro da equipe, ex.: "owner" ou "member".
invitationStatusstringopcional
O estado de convite do membro: "invited", "accepted", ou null para um membro que nunca passou pelo fluxo de convite.
lastSessionAtstringopcional
Quando o membro teve por último uma sessão ativa, como timestamp ISO 8601, ou null se nunca.
createdAtstringopcional
Quando o membro da equipe foi criado, como timestamp ISO 8601.
weeklyHoursCapacitynumberopcional
A capacidade de horas semanais de trabalho do membro, ou null se não definida.
permissionsobjectopcional
Flags de acesso por módulo (dashboard, clients, listings, etc.), ou null se nunca definidas.
slackUserIdstringopcional
O ID de usuário do Slack vinculado a este membro, ou null se nenhum.
statusstring (Owner | Invited | Active | Not Active)opcional
Um resumo calculado do estado do membro: "Owner", "Invited", "Active", ou "Not Active" (aceito, mas sem sessão nos últimos 7 dias).
Erros
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
get/api/v1/team/members
Sua chave de API
{
"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"
}
]
}Guias que usam este 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.