Skip to main content
POST
Add Contact To Deal

Auth

Requires a CRM manage scope and an active organization on the token. Any *:manage scope qualifies — in practice contacts:manage, deals:manage, companies:manage, or activities:manage.

Response

201 with the created deal_contacts row: {deal_id, contact_id, role, is_champion, id, org_id, created_at, added_at}.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

deal_id
string
required

The deal's id.

Body

application/json
contact_id
string
required

Contact id to link to the deal.

role
enum<string> | null

Contact's buying-committee role on this deal.

Available options:
champion,
decision_maker,
influencer,
economic_buyer,
technical_evaluator,
blocker,
user,
other
is_champion
boolean
default:false

Mark this contact as the deal's champion.

Response

Successful Response