Skip to main content

CreateContactRole creates a new contact role for the organization.

POST 
/api/v1/engagements/contacts/roles

Contact roles define the person's decision-making capacity.

Common Roles​

  • decision_maker: Has authority to approve purchases
  • influencer: Influences but doesn't make final decision
  • user: End user of product/service
  • champion: Internal advocate for your solution
  • gatekeeper: Controls access to decision makers

Parameters​

  • name: Required, unique name within organization (max 100 chars)
  • description: Optional, explains the role's meaning

Response​

Returns the created contact role with assigned ID.

Errors​

  • INVALID_ARGUMENT: Name is empty or exceeds 100 characters
  • ALREADY_EXISTS: Role with same name exists in organization
  • PERMISSION_DENIED: Caller lacks contacts:settings:write permission

Request​

Responses​

A successful response.