Skip to main content
POST
/
crm
/
v3
/
properties
/
{objectType}
/
groups
Create a property group
curl --request POST \
  --url https://api.hubapi.com/crm/v3/properties/{objectType}/groups \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "displayOrder": -1,
  "label": "My Property Group",
  "name": "mypropertygroup"
}
'
{
  "createdResourceId": "<string>",
  "entity": {
    "displayOrder": -1,
    "label": "My Property Group",
    "name": "mypropertygroup"
  },
  "location": "<string>"
}

Supported products

Requires one of the following products or higher.
Marketing HubMarketing Hub -Free
Sales HubSales Hub -Free
Service HubService Hub -Free
Content HubContent Hub -Free
Data HubData Hub -Free

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
objectType
string
required

Body

application/json
​
label
string
required

A human-readable label that will be shown in HubSpot.

​
name
string
required

The internal property group name, which must be used when referencing the property group via the API.

​
displayOrder
integer<int32>

Property groups are displayed in order starting with the lowest positive integer value. Values of -1 will cause the property group to be displayed after any positive values.

Response

successful operation

​
createdResourceId
string
required
​
entity
object
required

An ID for a group of properties

Example:
{
  "displayOrder": -1,
  "label": "My Property Group",
  "name": "mypropertygroup"
}
​
location
string
Last modified on December 16, 2025