People

Read who an API key acts as, and list the members, teams and tags of your agency through the Fondaro API.

These routes tell you who a key acts as and give you the ids you need to assign leads, tasks and deals, and to tag leads. GET /v1/me needs no scope. The other three need crm:read and are open to every member as well as admins. None of them needs an active plan.

Each list is returned whole, as { "data": [...], "hasMore": false }.

Check who a key acts as

GET /v1/me

Returns the person, agency, role and key behind the credential. Any valid key with an owner can call it.

bash
curl https://api.fondaro.com/v1/me \  -H "Authorization: Bearer $FONDARO_API_KEY"
json
{  "user": { "id": "user_2abcDEF1234567890ghiJKL", "name": "Alex Morgan", "email": "alex@example.com" },  "organization": { "id": "3f6c2a10-0000-4000-8000-000000000001", "name": "Example Realty" },  "role": "admin",  "entitled": true,  "key": {    "id": "3f6c2a10-0000-4000-8000-000000000014",    "name": "Reporting script",    "prefixHint": "fondaro_pk_***",    "scopes": ["crm:read", "crm:write", "properties:read", "sources:read", "brochures:read", "brochures:write", "documents:read", "documents:write"],    "expiresAt": "2026-11-03T13:01:47.714Z"  }}

role is admin or member. entitled is false when the agency has no active plan: CRM writes and every documents route answer 403 with SUBSCRIPTION_REQUIRED; reads and brochures still work.

List members

GET /v1/members

The people in your agency, up to 100, so you can choose owners for a lead, task or deal. Their ids are the userId values.

bash
curl https://api.fondaro.com/v1/members \  -H "Authorization: Bearer $FONDARO_API_KEY"
json
{  "data": [    {      "userId": "user_2abcDEF1234567890ghiJKL",      "firstName": "Alex",      "lastName": "Morgan",      "email": "alex@example.com",      "imageUrl": "https://example.com/avatar.png",      "role": "org:admin"    }  ],  "hasMore": false}

List teams

GET /v1/teams

The agency's teams with their member ids. Archived teams are not listed. Pass a team id as teamIds on the owner fields of leads, tasks and deals to give something to the whole team.

bash
curl https://api.fondaro.com/v1/teams \  -H "Authorization: Bearer $FONDARO_API_KEY"
json
{  "data": [    { "id": "3f6c2a10-0000-4000-8000-000000000015", "name": "Sales", "color": "red", "memberIds": ["user_2mnoPQR1234567890stuVWX"], "memberCount": 1 }  ],  "hasMore": false}

List tags

GET /v1/tags

The agency's tags with how many leads carry each. Use the ids with Set the tags on a lead.

bash
curl https://api.fondaro.com/v1/tags \  -H "Authorization: Bearer $FONDARO_API_KEY"
json
{  "data": [    {      "id": "3f6c2a10-0000-4000-8000-000000000006",      "name": "BrandNewTag",      "color": "slate",      "createdBy": "user_2abcDEF1234567890ghiJKL",      "archivedAt": null,      "assigneeIds": [],      "teamIds": [],      "createdAt": "2026-06-10T11:00:02.001Z",      "updatedAt": "2026-06-10T11:00:02.001Z",      "leadCount": 0    }  ],  "hasMore": false}