[metadata]
apple-mobile-web-app-title: HubSpot docs
application-name: HubSpot docs
description: Create a CRM object with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard objects is provided.
generator: Mintlify
language: en
msapplication-TileColor: #ff4800
msapplication-config: /docs/_mintlify/favicons/hubspot/Yga26WrQoaJFAQa3/_generated/favicon/browserconfig.xml
og:description: Create a CRM object with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard objects is provided.
og:image: https://hubspot.mintlify.app/_next/image?url=%2F_mintlify%2Fapi%2Fog%3Fdivision%3DObjects%26appearance%3Dlight%26title%3DCreate%26description%3DCreate%2Ba%2BCRM%2Bobject%2Bwith%2Bthe%2Bgiven%2Bproperties%2Band%2Breturn%2Ba%2Bcopy%2Bof%2Bthe%2Bobject%252C%2Bincluding%2Bthe%2BID.%2BDocumentation%2Band%2Bexamples%2Bfor%2Bcreating%2Bstandard%2Bobjects%2Bis%2Bpro%26logoLight%3Dhttps%253A%252F%252Fmintcdn.com%252Fhubspot%252FCzYDAsNnXNN88BYe%252Flogo%252Flogo.svg%253Ffit%253Dmax%2526auto%253Dformat%2526n%253DCzYDAsNnXNN88BYe%2526q%253D85%2526s%253Dbb0a0ea3314b4a516149fa3b933d4633%26logoDark%3Dhttps%253A%252F%252Fmintcdn.com%252Fhubspot%252FCzYDAsNnXNN88BYe%252Flogo%252Flogo.svg%253Ffit%253Dmax%2526auto%253Dformat%2526n%253DCzYDAsNnXNN88BYe%2526q%253D85%2526s%253Dbb0a0ea3314b4a516149fa3b933d4633%26primaryColor%3D%2523ff4800%26lightColor%3D%2523ff4800%26backgroundLight%3D%2523ffffff%26backgroundDark%3D%2523041617&w=1200&q=100
og:image:height: 630
og:image:width: 1200
og:site_name: HubSpot docs
og:title: Create - HubSpot docs
og:type: website
og:url: https://developers.hubspot.com/docs/api-reference/legacy/crm/objects/objects/create-object
twitter:card: summary_large_image
twitter:description: Create a CRM object with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard objects is provided.
twitter:image: https://hubspot.mintlify.app/_next/image?url=%2F_mintlify%2Fapi%2Fog%3Fdivision%3DObjects%26appearance%3Dlight%26title%3DCreate%26description%3DCreate%2Ba%2BCRM%2Bobject%2Bwith%2Bthe%2Bgiven%2Bproperties%2Band%2Breturn%2Ba%2Bcopy%2Bof%2Bthe%2Bobject%252C%2Bincluding%2Bthe%2BID.%2BDocumentation%2Band%2Bexamples%2Bfor%2Bcreating%2Bstandard%2Bobjects%2Bis%2Bpro%26logoLight%3Dhttps%253A%252F%252Fmintcdn.com%252Fhubspot%252FCzYDAsNnXNN88BYe%252Flogo%252Flogo.svg%253Ffit%253Dmax%2526auto%253Dformat%2526n%253DCzYDAsNnXNN88BYe%2526q%253D85%2526s%253Dbb0a0ea3314b4a516149fa3b933d4633%26logoDark%3Dhttps%253A%252F%252Fmintcdn.com%252Fhubspot%252FCzYDAsNnXNN88BYe%252Flogo%252Flogo.svg%253Ffit%253Dmax%2526auto%253Dformat%2526n%253DCzYDAsNnXNN88BYe%2526q%253D85%2526s%253Dbb0a0ea3314b4a516149fa3b933d4633%26primaryColor%3D%2523ff4800%26lightColor%3D%2523ff4800%26backgroundLight%3D%2523ffffff%26backgroundDark%3D%2523041617&w=1200&q=100
twitter:image:height: 630
twitter:image:width: 1200
twitter:title: Create - HubSpot docs
viewport: width=device-width, initial-scale=1, viewport-fit=cover

[canonical-links]
https://developers.hubspot.com/docs/api-reference/legacy/crm/objects/objects/create-object

[document-links]
/docs/llms.txt: /docs/llms.txt
Changelog: https://developers.hubspot.com/changelog
HubSpot docs home page: /docs
Sign up: https://app.hubspot.com/signup-hubspot/crm?intent=developer
facebook: https://www.facebook.com/hubspot
instagram: https://www.instagram.com/hubspot
linkedin: https://www.linkedin.com/company/hubspot
medium: https://medium.com/@HubSpot
x: https://x.com/HubSpot
youtube: https://youtube.com/user/HubSpot

[structured-data]
{"@context":"https://schema.org","@graph":[{"@id":"https://developers.hubspot.com/#organization","@type":"Organization","logo":{"@type":"ImageObject","url":"https://mintcdn.com/hubspot/CzYDAsNnXNN88BYe/logo/logo.svg?fit=max&auto=format&n=CzYDAsNnXNN88BYe&q=85&s=bb0a0ea3314b4a516149fa3b933d4633"},"name":"HubSpot docs","url":"https://developers.hubspot.com"},{"@id":"https://developers.hubspot.com/docs#website","@type":"WebSite","name":"HubSpot docs","publisher":{"@id":"https://developers.hubspot.com/#organization"},"url":"https://developers.hubspot.com/docs"},{"@id":"https://developers.hubspot.com/docs/api-reference/legacy/crm/objects/objects/create-object#webpage","@type":"WebPage","breadcrumb":{"@id":"https://developers.hubspot.com/docs/api-reference/legacy/crm/objects/objects/create-object#breadcrumb"},"dateModified":"2026-03-30T14:56:22.000Z","description":"Create a CRM object with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard objects is provided.","isPartOf":{"@id":"https://developers.hubspot.com/docs#website"},"name":"Create","url":"https://developers.hubspot.com/docs/api-reference/legacy/crm/objects/objects/create-object"},{"@id":"https://developers.hubspot.com/docs/api-reference/legacy/crm/objects/objects/create-object#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://developers.hubspot.com/docs/api-reference/legacy/crm/embed","name":"CRM","position":1},{"@type":"ListItem","item":"https://developers.hubspot.com/docs/api-reference/legacy/crm/objects/appointments/create-appointment","name":"Objects","position":2},{"@type":"ListItem","item":"https://developers.hubspot.com/docs/api-reference/legacy/crm/objects/objects/create-object","name":"Create","position":3}]},{"@id":"https://developers.hubspot.com/docs/api-reference/legacy/crm/objects/objects/create-object#apireference","@type":["TechArticle","APIReference"],"dateModified":"2026-03-30T14:56:22.000Z","description":"Create a CRM object with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard objects is provided.","headline":"Create","isPartOf":{"@id":"https://developers.hubspot.com/docs#website"},"mainEntityOfPage":{"@id":"https://developers.hubspot.com/docs/api-reference/legacy/crm/objects/objects/create-object#webpage"},"name":"Create","publisher":{"@id":"https://developers.hubspot.com/#organization"},"url":"https://developers.hubspot.com/docs/api-reference/legacy/crm/objects/objects/create-object"}]}

[content]
Create - HubSpot docs
Documentation Index
Fetch the complete documentation index at:
/docs/llms.txt
Use this file to discover all available pages before exploring further.
Skip to main content
HubSpot docs
home page
Search...
⌘
K
Ask Assistant
Changelog
Sign up
Sign up
Search...
Navigation
Objects
Create
close
Create
cURL
curl
--request
POST
\
--url
https://api.hubapi.com/crm/v3/objects/{objectType}
\
--header
'Authorization: Bearer <token>'
\
--header
'Content-Type: application/json'
\
--data
'
{
"associations": [
{
"to": {
"id": "<string>"
},
"types": [
{
"associationTypeId": 123
}
]
}
],
"properties": {}
}
'
import requests url = "https://api.hubapi.com/crm/v3/objects/{objectType}" payload = { "associations": [ { "to": { "id": "<string>" }, "types": [{ "associationTypeId": 123 }] } ], "properties": {} } headers = { "Authorization": "Bearer <token>", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.text)
const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: JSON.stringify({ associations: [{to: {id: '<string>'}, types: [{associationTypeId: 123}]}], properties: {} }) }; fetch('https://api.hubapi.com/crm/v3/objects/{objectType}', options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err));
<?php $curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => "https://api.hubapi.com/crm/v3/objects/{objectType}", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => json_encode([ 'associations' => [ [ 'to' => [ 'id' => '<string>' ], 'types' => [ [ 'associationTypeId' => 123 ] ] ] ], 'properties' => [ ] ]), CURLOPT_HTTPHEADER => [ "Authorization: Bearer <token>", "Content-Type: application/json" ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; }
package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.hubapi.com/crm/v3/objects/{objectType}" payload := strings.NewReader("{\n \"associations\": [\n {\n \"to\": {\n \"id\": \"<string>\"\n },\n \"types\": [\n {\n \"associationTypeId\": 123\n }\n ]\n }\n ],\n \"properties\": {}\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer <token>") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) }
HttpResponse<String> response = Unirest.post("https://api.hubapi.com/crm/v3/objects/{objectType}") .header("Authorization", "Bearer <token>") .header("Content-Type", "application/json") .body("{\n \"associations\": [\n {\n \"to\": {\n \"id\": \"<string>\"\n },\n \"types\": [\n {\n \"associationTypeId\": 123\n }\n ]\n }\n ],\n \"properties\": {}\n}") .asString();
require 'uri' require 'net/http' url = URI("https://api.hubapi.com/crm/v3/objects/{objectType}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer <token>' request["Content-Type"] = 'application/json' request.body = "{\n \"associations\": [\n {\n \"to\": {\n \"id\": \"<string>\"\n },\n \"types\": [\n {\n \"associationTypeId\": 123\n }\n ]\n }\n ],\n \"properties\": {}\n}" response = http.request(request) puts response.read_body
201
default
{
"archived"
:
false
,
"createdAt"
:
"2019-10-30T03:30:17.883Z"
,
"id"
:
"512"
,
"properties"
: {
"property_checkbox"
:
"false"
,
"property_date"
:
"1572480000000"
,
"property_dropdown"
:
"choice_b"
,
"property_multiple_checkboxes"
:
"chocolate;strawberry"
,
"property_number"
:
"17"
,
"property_radio"
:
"option_1"
,
"property_string"
:
"value"
},
"updatedAt"
:
"2019-12-07T16:50:06.678Z"
}
{ "message": "Invalid input (details will vary based on the error)", "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf", "category": "VALIDATION_ERROR", "links": { "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base" } }
Objects
Create
Create a CRM object with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard objects is provided.
POST
/
crm
/
v3
/
objects
/
{objectType}
Try it
Create
cURL
curl
--request
POST
\
--url
https://api.hubapi.com/crm/v3/objects/{objectType}
\
--header
'Authorization: Bearer <token>'
\
--header
'Content-Type: application/json'
\
--data
'
{
"associations": [
{
"to": {
"id": "<string>"
},
"types": [
{
"associationTypeId": 123
}
]
}
],
"properties": {}
}
'
import requests url = "https://api.hubapi.com/crm/v3/objects/{objectType}" payload = { "associations": [ { "to": { "id": "<string>" }, "types": [{ "associationTypeId": 123 }] } ], "properties": {} } headers = { "Authorization": "Bearer <token>", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.text)
const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: JSON.stringify({ associations: [{to: {id: '<string>'}, types: [{associationTypeId: 123}]}], properties: {} }) }; fetch('https://api.hubapi.com/crm/v3/objects/{objectType}', options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err));
<?php $curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => "https://api.hubapi.com/crm/v3/objects/{objectType}", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => json_encode([ 'associations' => [ [ 'to' => [ 'id' => '<string>' ], 'types' => [ [ 'associationTypeId' => 123 ] ] ] ], 'properties' => [ ] ]), CURLOPT_HTTPHEADER => [ "Authorization: Bearer <token>", "Content-Type: application/json" ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; }
package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.hubapi.com/crm/v3/objects/{objectType}" payload := strings.NewReader("{\n \"associations\": [\n {\n \"to\": {\n \"id\": \"<string>\"\n },\n \"types\": [\n {\n \"associationTypeId\": 123\n }\n ]\n }\n ],\n \"properties\": {}\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer <token>") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) }
HttpResponse<String> response = Unirest.post("https://api.hubapi.com/crm/v3/objects/{objectType}") .header("Authorization", "Bearer <token>") .header("Content-Type", "application/json") .body("{\n \"associations\": [\n {\n \"to\": {\n \"id\": \"<string>\"\n },\n \"types\": [\n {\n \"associationTypeId\": 123\n }\n ]\n }\n ],\n \"properties\": {}\n}") .asString();
require 'uri' require 'net/http' url = URI("https://api.hubapi.com/crm/v3/objects/{objectType}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer <token>' request["Content-Type"] = 'application/json' request.body = "{\n \"associations\": [\n {\n \"to\": {\n \"id\": \"<string>\"\n },\n \"types\": [\n {\n \"associationTypeId\": 123\n }\n ]\n }\n ],\n \"properties\": {}\n}" response = http.request(request) puts response.read_body
201
default
{
"archived"
:
false
,
"createdAt"
:
"2019-10-30T03:30:17.883Z"
,
"id"
:
"512"
,
"properties"
: {
"property_checkbox"
:
"false"
,
"property_date"
:
"1572480000000"
,
"property_dropdown"
:
"choice_b"
,
"property_multiple_checkboxes"
:
"chocolate;strawberry"
,
"property_number"
:
"17"
,
"property_radio"
:
"option_1"
,
"property_string"
:
"value"
},
"updatedAt"
:
"2019-12-07T16:50:06.678Z"
}
{ "message": "Invalid input (details will vary based on the error)", "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf", "category": "VALIDATION_ERROR", "links": { "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base" } }
Supported products
Required Scopes
Authorizations
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
oauth2
​
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
Is the input object used to create a new CRM object, containing the properties to be set and optional associations to link the new record with other CRM objects.
​
associations
object[]
required
Show
child attributes
​
properties
object
required
Key-value pairs for setting properties for the new object.
Show
child attributes
Response
201
application/json
successful operation
A simple public object.
​
archived
boolean
required
Whether the object is archived.
​
createdAt
string<date-time>
required
The timestamp when the object was created, in ISO 8601 format.
​
id
string
required
The unique ID of the object.
​
properties
object
required
Key-value pairs representing the properties of the object.
Show
child attributes
​
updatedAt
string<date-time>
required
The timestamp when the object was last updated, in ISO 8601 format.
​
archivedAt
string<date-time>
The timestamp when the object was archived, in ISO 8601 format.
​
objectWriteTraceId
string
An identifier used for tracing the write request for the object.
​
propertiesWithHistory
object
Key-value pairs representing the properties of the object along with their history.
Show
child attributes
​
url
string
Direct URL for this object in the portal
​
warnings
object[]
Show
child attributes
Last modified on
March 30, 2026
Was this page helpful?
Yes
No
⌘
I
facebook
instagram
youtube
x
linkedin
medium
Assistant
Responses are generated using AI and may contain mistakes.
