Team data can also be embedded directly in deal list and detail responses using
?include=teamonGET /build/dealsorGET /deals/{deal_id}. See Deals for details.
List Team
/api/external/v2/deals/{deal_id}/teamList all team members assigned to a deal
Response (200):
{
"request_id": "...",
"timestamp": "2026-03-20T15:30:45Z",
"data": [
{
"id": 401,
"user_id": 1234,
"first_name": "Jane",
"last_name": "Smith",
"email": "jane@example.com",
"deal_role": "deal_lead",
"is_primary": true,
"permission": null,
"photo_url": null
}
]
}unauthorizedAuthentication required— Missing or invalid Authorization header
not_foundDeal not found— The deal_id doesn't exist or isn't accessible to the authenticated user
Team Member Object
| Field | Type | Description |
|---|---|---|
id | integer | Team assignment identifier |
user_id | integer|null | User ID |
first_name | string|null | First name |
last_name | string|null | Last name |
email | string|null | Email address |
deal_role | string|null | Team role (deal_lead, originator, closer, etc.) |
is_primary | boolean | Whether this is the primary team member |
permission | string|null | Permission level |
photo_url | string|null | Profile photo URL |