Skip to main content
POST
/
v1
/
groups
Create a group
curl --request POST \
  --url https://api.prod.getdex.com/v1/groups/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "group": {
    "name": "<string>",
    "emoji": "<string>",
    "description": "<string>",
    "parent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "parent": "<unknown>",
    "groups_contacts": [
      {
        "contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "contact": "<unknown>"
      }
    ]
  }
}
'
{
  "error": true,
  "data": {
    "group": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "color": "<string>",
      "parent_group_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "<string>",
      "updated_at": "<string>"
    }
  }
}

Use cases

  • Let users create custom groups to organize their contacts
  • Programmatically create groups when importing data from another CRM
  • Set up default groups for new users during onboarding

Authorizations

Authorization
string
header
required

Use your Dex API key (e.g. dex_abc123...) as the Bearer token.

Body

application/json
group
object
required

Response

Successful response

error
boolean
required
data
object
required