Deals

Add a team member

POST/deals/{dealId}/team
deals:writeadd_team_memberDeprecatedSunset 2027-06-30

Adds a team member to the deal. The new member is appended at the end of the team display order, and the team tab is enabled so it shows. Deprecated: it will be withdrawn on 2027-06-30. /deals/{deal_id}/team-members replaces it; the Link header names the replacement.

Path parameters

  • dealIdstring (uuid)Required#

    The deal's public uuid.

Request body

application/json, required

  • namestringRequired#
  • job_titlestring | null#
  • biostring | null#
  • linkedin_usernamestring | null#
  • twitter_usernamestring | null#
  • image_idstring | null#
{
  "name": "Grace Hopper",
  "job_title": "Founder",
  "bio": "Pioneer of the deal.",
  "linkedin_username": "grace",
  "twitter_username": "grace_h"
}

Responses

201

Created

TeamMember
{
  "data": {
    "id": "9c4b1d2e-3f5a-4b6c-8d7e-0f1a2b3c4d5e",
    "name": "Ada Lovelace",
    "job_title": "Managing Partner",
    "bio": "20 years in venture.",
    "image_id": null,
    "linkedin_username": "adalovelace",
    "twitter_username": "ada",
    "order": 1,
    "created_at": "2026-06-15T10:30:00+00:00",
    "updated_at": "2026-06-15T10:30:00+00:00"
  }
}
401

Authentication failed. error.code is one of invalid_token, expired, revoked.

Error
403

Authorization failed. error.code is one of org_disabled, ip_blocked, missing_scope, scope_disabled, user_disabled.

Error
404

Resource not found (error.code = not_found).

Error
422

Request validation failed (HTTP 422). The body is either the Laravel validation envelope (message + field-keyed errors) or the API error envelope for domain rejections (e.g. form_type_not_supported, folder_locked, parent_not_found, folder_not_empty).

429

Rate limit exceeded (error.code = rate_limited).

Error

Examples

curl -X POST https://your-org-domain/kong/core/api/v2/deals/{dealId}/team\
  -H "Authorization: Bearer $HELM_API_KEY"\
  -H "Content-Type: application/json"\
  -d '{
  "name": "Grace Hopper",
  "job_title": "Founder",
  "bio": "Pioneer of the deal.",
  "linkedin_username": "grace",
  "twitter_username": "grace_h"
}'