Ta strona nie została jeszcze przetłumaczona na Twój język. Wyświetlamy wersję angielski (Wielka Brytania).

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}