Skip to main content

CreateGroup creates a new contact group for the organization.

POST 
/api/v1/engagements/contacts/groups

Groups enable custom segmentation for campaigns, reporting, and filtering.

Use Cases​

  • Campaign targeting: "Q4 Promotion Targets"
  • Customer segments: "Enterprise Accounts", "SMB Customers"
  • Geographic regions: "East Coast", "EMEA"
  • Product interest: "Product A Prospects"

Parameters​

  • name: Required, unique name within organization (max 100 chars)

Response​

Returns the created group with assigned ID.

Errors​

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

Request​

Responses​

A successful response.