Skip to main content
POST
/
properties
/
v2
/
{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
}

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 March 30, 2026