Create an object property group

curl --request POST \
  --url https://api.hubapi.com/properties/v2/{object_type}/groups \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "displayName": "<string>",
  "displayOrder": 123
}
'

{
  "name": "<string>",
  "displayName": "<string>",
  "displayOrder": 123,
  "hubspotDefined": true,
  "portalId": 123
}

POST

properties

{object_type}

groups

Create an object property group

curl --request POST \
  --url https://api.hubapi.com/properties/v2/{object_type}/groups \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "displayName": "<string>",
  "displayOrder": 123
}
'

{
  "name": "<string>",
  "displayName": "<string>",
  "displayOrder": 123,
  "hubspotDefined": true,
  "portalId": 123
}

Scope requirements

Path Parameters

object_type

string

required

The specific type of CRM object to create the property group for. You can use the object name (e.g., contacts) or the objectTypeId (e.g., 0-1).

Body

application/json

name

string

required

The internal name of the property group. Must be unique and use only lowercase letters, numbers, and underscores.

displayName

string

required

The displayed name of the group

displayOrder

integer

The order of the group. Defaults to -1 if omitted.

Response

201 - application/json

Object property group created successfully

name

string

The internal name of the property group

displayName

string

The displayed name of the group

displayOrder

integer

The order of the group when displaying properties

hubspotDefined

boolean

Whether the group is defined by HubSpot

portalId

integer

The portal ID this group belongs to

Last modified on December 12, 2025