> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create > Create a CRM object with the specified properties and return a copy of the object, including its ID. This endpoint allows you to create standard objects in your CRM system, providing documentation and examples for guidance. > [accordion] Supported products > [accordion] Required Scopes Supports [user-level access](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/user-level-apps.md). ## OpenAPI ````yaml specs/2026-09/crm-custom-objects-v2026-09.json POST /crm/objects/2026-09/{objectType} openapi: 3.0.1 info: title: Custom Objects description: Basepom for all HubSpot Projects version: 2026-09 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-api-use-case: >- After creating a Cars custom object, you can create a record for each car, then associate it with the contact who bought it. x-hubspot-introduction: >- Use the objects API to create and manage records for an object. The endpoints can be used for objects included in all accounts, such as contacts and companies, as well as for custom objects in Enterprise accounts. servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic - name: Batch - name: Search paths: /crm/objects/2026-09/{objectType}: post: tags: - Basic summary: Create description: >- Create a CRM object with the specified properties and return a copy of the object, including its ID. This endpoint allows you to create standard objects in your CRM system, providing documentation and examples for guidance. operationId: >- post-/crm/objects/2026-09/{objectType}_/crm/objects/2026-09-beta/{objectType} parameters: - name: objectType in: path description: >- The type of CRM object to create, such as contacts, companies, or deals. required: true style: simple explode: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SimplePublicObjectInputForCreate' required: true responses: '201': description: successful operation headers: Location: description: URL of the newly created resource style: simple explode: false schema: type: string content: application/json: schema: $ref: '#/components/schemas/SimplePublicObject' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.objects.deals.read - oauth2: - crm.objects.subscriptions.read - oauth2: - crm.objects.services.read - oauth2: - crm.objects.tickets.sensitive.read - oauth2: - crm.objects.orders.read - oauth2: - crm.objects.listings.write - oauth2: - crm.objects.custom.read - oauth2: - crm.objects.companies.write - oauth2: - crm.objects.tasks.read - oauth2: - crm.objects.custom.sensitive.write.v2 - oauth2: - crm.objects.custom.highly_sensitive.write.v2 - oauth2: - crm.objects.companies.read - oauth2: - crm.objects.appointments.sensitive.read.v2 - oauth2: - crm.objects.contacts.highly_sensitive.read.v2 - oauth2: - crm.objects.tickets.highly_sensitive.read - oauth2: - crm.objects.companies.sensitive.read.v2 - oauth2: - crm.objects.tickets.sensitive.write - oauth2: - media_bridge.read - oauth2: - crm.objects.deals.highly_sensitive.read.v2 - oauth2: - crm.objects.contacts.highly_sensitive.write.v2 - oauth2: - crm.objects.companies.highly_sensitive.read.v2 - oauth2: - crm.objects.commercepayments.write - oauth2: - crm.objects.invoices.write - oauth2: - crm.objects.contacts.sensitive.write.v2 - oauth2: - crm.objects.calls.read - oauth2: - crm.objects.users.write - oauth2: - crm.objects.meetings.read - oauth2: - crm.objects.custom.sensitive.read.v2 - oauth2: - crm.objects.users.read - oauth2: - crm.objects.partner-services.read - oauth2: - crm.objects.orders.write - oauth2: - crm.objects.partner-services.write - oauth2: - crm.objects.appointments.write - oauth2: - crm.objects.projects.highly_sensitive.write - oauth2: - crm.objects.carts.write - oauth2: - crm.objects.tickets.highly_sensitive.write - oauth2: - crm.objects.commercepayments.read - oauth2: - crm.objects.products.write - oauth2: - crm.objects.feedback_submissions.read - oauth2: - crm.objects.services.write - oauth2: - crm.objects.subscriptions.write - oauth2: - crm.objects.deals.sensitive.write.v2 - oauth2: - crm.objects.contacts.read - oauth2: - crm.objects.appointments.sensitive.write.v2 - oauth2: - crm.objects.projects.highly_sensitive.read - oauth2: - crm.objects.invoices.read - oauth2: - crm.objects.custom.write - oauth2: - tickets.sensitive.v2 - oauth2: - crm.objects.deals.write - oauth2: - e-commerce - oauth2: - crm.objects.appointments.read - oauth2: - crm.objects.projects.read - oauth2: - crm.objects.companies.sensitive.write.v2 - oauth2: - crm.objects.companies.highly_sensitive.write.v2 - oauth2: - crm.objects.deals.highly_sensitive.write.v2 - oauth2: - crm.objects.custom.highly_sensitive.read.v2 - oauth2: - crm.objects.goals.write - oauth2: - crm.objects.projects.sensitive.read - oauth2: - crm.objects.line_items.write - oauth2: - crm.objects.contacts.write - oauth2: - crm.objects.goals.read - oauth2: - crm.objects.line_items.read - oauth2: - crm.objects.partner-clients.write - oauth2: - crm.objects.projects.write - oauth2: - crm.objects.projects.sensitive.write - oauth2: - crm.objects.deals.sensitive.read.v2 - oauth2: - crm.objects.quotes.write - oauth2: - tickets.highly_sensitive.v2 - oauth2: - crm.objects.leads.read - oauth2: - crm.objects.leads.write - oauth2: - crm.objects.carts.read - oauth2: - crm.objects.emails.read - oauth2: - crm.objects.quotes.read - oauth2: - crm.objects.courses.write - oauth2: - crm.objects.partner-clients.read - oauth2: - crm.objects.notes.read - oauth2: - crm.objects.courses.read - oauth2: - crm.objects.listings.read - oauth2: - crm.objects.contacts.sensitive.read.v2 - oauth2: - crm.objects.products.read components: schemas: SimplePublicObjectInputForCreate: required: - associations - properties type: object properties: associations: type: array description: >- An array of associations that link the new CRM object to other existing objects. Each association specifies the related object and the type of relationship. items: $ref: '#/components/schemas/PublicAssociationsForObject' properties: type: object additionalProperties: type: string description: >- An object containing key-value pairs where each key is a property name and each value is the property's value. These properties define the characteristics of the CRM object being created. description: >- 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. SimplePublicObject: required: - archived - createdAt - id - properties - updatedAt type: object properties: archived: type: boolean description: A boolean indicating whether this object is archived. archivedAt: type: string description: The date and time when this object was archived, in ISO 8601 format. format: date-time createdAt: type: string description: The date and time when this object was created, in ISO 8601 format. format: date-time id: type: string description: The unique identifier for this object, represented as a string. objectWriteTraceId: type: string description: A string used to trace the write operations for this object. properties: type: object additionalProperties: type: string description: >- A map of property names to their corresponding values, where each value is a string. propertiesWithHistory: type: object additionalProperties: type: array items: $ref: '#/components/schemas/ValueWithTimestamp' description: >- A map of property names to arrays of values with timestamps, showing the history of changes for each property. updatedAt: type: string description: >- The date and time when this object was last updated, in ISO 8601 format. format: date-time url: type: string description: A string representing the URL associated with this object. warnings: type: array description: >- An array of warnings related to this object, each containing a category, message, and context. items: $ref: '#/components/schemas/PublicObjectWarning' description: A simple public object. PublicAssociationsForObject: required: - to - types type: object properties: to: $ref: '#/components/schemas/PublicObjectId' types: type: array description: >- An array of association specifications, each detailing the type of association between the objects. Each item in the array is a reference to the 'AssociationSpec' schema, which defines the category and type ID of the association. items: $ref: '#/components/schemas/AssociationSpec' description: >- Represents the associations for a specific object in HubSpot, detailing the types of associations and the related objects involved. ValueWithTimestamp: required: - sourceType - timestamp - value type: object properties: sourceId: type: string description: >- The identifier of the source from which the value originated. This is a string. sourceLabel: type: string description: A label describing the source of the value. This is a string. sourceType: type: string description: >- The type of source from which the value originated. This is a string. timestamp: type: string description: The date and time when the value was recorded, in ISO 8601 format. format: date-time updatedByUserId: type: integer description: >- The user ID of the person who last updated the value. This is an integer. format: int32 value: type: string description: >- The value associated with the timestamp. It is represented as a string. description: Property model that includes timestamp. PublicObjectWarning: required: - category - context - message type: object properties: category: type: string description: A string indicating the category of the warning. context: type: object additionalProperties: type: string description: >- An object providing additional context for the warning, with string values. message: type: string description: A string containing the warning message. description: >- Represents a warning message related to a public object in HubSpot, providing details about the nature and context of the warning. Error: required: - category - correlationId - message type: object properties: category: type: string description: The error category. context: type: object additionalProperties: type: array items: type: string description: >- Context about the error condition, represented as an object with additional properties that are arrays of strings. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- A unique identifier for the request. Include this value with any error reports or support tickets. It is formatted as a UUID. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: >- Further information about the error, represented as an array of ErrorDetail objects. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- A map of link names to associated URIs containing documentation about the error or recommended remediation steps. message: type: string description: >- A human readable message describing the error along with remediation steps where appropriate. example: An error occurred subCategory: type: string description: >- A specific category that contains more specific detail about the error. description: >- Represents an error response returned by the API when an operation fails. This component is used in various endpoints to provide detailed information about the error encountered. example: 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 PublicObjectId: required: - id type: object properties: id: type: string description: The unique identifier for the object, represented as a string. description: Contains the Id of a Public Object AssociationSpec: required: - associationCategory - associationTypeId type: object properties: associationCategory: type: string description: >- The category of the association, indicating its origin or purpose. Valid values include 'HUBSPOT_DEFINED', 'USER_DEFINED', 'INTEGRATOR_DEFINED', and 'WORK'. enum: - HUBSPOT_DEFINED - INTEGRATOR_DEFINED - USER_DEFINED - WORK associationTypeId: type: integer description: >- An integer representing the unique identifier for the type of association. format: int32 description: >- Defines the type, direction, and details of the relationship between two CRM objects. ErrorDetail: required: - message type: object properties: code: type: string description: The status code associated with the error detail. This is a string. context: type: object additionalProperties: type: array items: type: string description: >- Context about the error condition, represented as an object with additional properties that are arrays of strings. example: '{missingScopes=[scope1, scope2]}' in: type: string description: >- The name of the field or parameter in which the error was found. This is a string. message: type: string description: >- A human readable message describing the error along with remediation steps where appropriate. This is a string. subCategory: type: string description: >- A specific category that contains more specific detail about the error. This is a string. description: >- Represents detailed information about an error that occurred in the API. This component is used to provide additional context and specifics about errors, typically as part of an error response. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: crm.objects.appointments.read: '' crm.objects.appointments.sensitive.read.v2: '' crm.objects.appointments.sensitive.write.v2: '' crm.objects.appointments.write: '' crm.objects.calls.read: '' crm.objects.carts.read: '' crm.objects.carts.write: '' crm.objects.commercepayments.read: '' crm.objects.commercepayments.write: '' crm.objects.companies.highly_sensitive.read.v2: '' crm.objects.companies.highly_sensitive.write.v2: '' crm.objects.companies.read: '' crm.objects.companies.sensitive.read.v2: '' crm.objects.companies.sensitive.write.v2: '' crm.objects.companies.write: '' crm.objects.contacts.highly_sensitive.read.v2: '' crm.objects.contacts.highly_sensitive.write.v2: '' crm.objects.contacts.read: '' crm.objects.contacts.sensitive.read.v2: '' crm.objects.contacts.sensitive.write.v2: '' crm.objects.contacts.write: '' crm.objects.courses.read: '' crm.objects.courses.write: '' crm.objects.custom.highly_sensitive.read.v2: '' crm.objects.custom.highly_sensitive.write.v2: '' crm.objects.custom.read: '' crm.objects.custom.sensitive.read.v2: '' crm.objects.custom.sensitive.write.v2: '' crm.objects.custom.write: '' crm.objects.deals.highly_sensitive.read.v2: '' crm.objects.deals.highly_sensitive.write.v2: '' crm.objects.deals.read: '' crm.objects.deals.sensitive.read.v2: '' crm.objects.deals.sensitive.write.v2: '' crm.objects.deals.write: '' crm.objects.emails.read: '' crm.objects.feedback_submissions.read: '' crm.objects.goals.read: '' crm.objects.goals.write: '' crm.objects.invoices.read: '' crm.objects.invoices.write: '' crm.objects.leads.read: '' crm.objects.leads.write: '' crm.objects.line_items.read: '' crm.objects.line_items.write: '' crm.objects.listings.read: '' crm.objects.listings.write: '' crm.objects.meetings.read: '' crm.objects.notes.read: '' crm.objects.orders.read: '' crm.objects.orders.write: '' crm.objects.partner-clients.read: '' crm.objects.partner-clients.write: '' crm.objects.partner-services.read: '' crm.objects.partner-services.write: '' crm.objects.products.read: '' crm.objects.products.write: '' crm.objects.projects.highly_sensitive.read: '' crm.objects.projects.highly_sensitive.write: '' crm.objects.projects.read: '' crm.objects.projects.sensitive.read: '' crm.objects.projects.sensitive.write: '' crm.objects.projects.write: '' crm.objects.quotes.read: '' crm.objects.quotes.write: '' crm.objects.services.read: '' crm.objects.services.write: '' crm.objects.subscriptions.read: '' crm.objects.subscriptions.write: '' crm.objects.tasks.read: '' crm.objects.tickets.highly_sensitive.read: '' crm.objects.tickets.highly_sensitive.write: '' crm.objects.tickets.sensitive.read: '' crm.objects.tickets.sensitive.write: '' crm.objects.users.read: '' crm.objects.users.write: '' e-commerce: '' media_bridge.read: '' tickets.highly_sensitive.v2: '' tickets.sensitive.v2: '' ````