Skip to main content

CreateContactType creates a new contact type for the organization.

POST 

/api/v1/engagements/contacts/types

Contact types classify the nature of the customer relationship.

Common Types

  • lead: New potential customer, not yet qualified
  • prospect: Qualified lead with buying potential
  • customer: Active paying customer
  • partner: Business partner or reseller
  • vendor: Supplier or service provider

Parameters

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

Response

Returns the created contact type with assigned ID.

Errors

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

Request

Responses

A successful response.