# Create a new Custom Object instance

POST https://api.close.com/api/v1/custom_object/
Content-Type: application/json

Custom Field values can be set using the format: `custom.{custom_field_id}`. See [Custom Fields](/resources/custom-fields/custom-object-custom-fields/).

The following fields are required:
  - `custom_object_type_id`: The type of Custom Object you are creating determines the Custom Fields that can be used.
  - `lead_id`: The Lead that this Custom Object instance will belong to.
  - `name`: Each Custom Object has a name, used for display.

Reference: https://developer.close.com/api/resources/custom-objects/create

## OpenAPI Specification

```yaml
openapi: 3.1.0
info:
  title: Close API
  version: 1.0.0
paths:
  /custom_object/:
    post:
      operationId: create
      summary: Create a new Custom Object instance
      description: >-
        Custom Field values can be set using the format:
        `custom.{custom_field_id}`. See [Custom
        Fields](/resources/custom-fields/custom-object-custom-fields/).


        The following fields are required:
          - `custom_object_type_id`: The type of Custom Object you are creating determines the Custom Fields that can be used.
          - `lead_id`: The Lead that this Custom Object instance will belong to.
          - `name`: Each Custom Object has a name, used for display.
      tags:
        - subpackage_customObjects
      parameters:
        - name: Authorization
          in: header
          description: Basic authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/custom_objects_create_Response_201'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                description: Any type
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                description: Any type
        '404':
          description: Not found
          content:
            application/json:
              schema:
                description: Any type
      requestBody:
        content:
          application/json:
            schema:
              description: Any type
servers:
  - url: https://api.close.com/api/v1
components:
  schemas:
    custom_objects_create_Response_201:
      type: object
      properties: {}
      description: Empty response body
      title: custom_objects_create_Response_201
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: basic
    OAuth2:
      type: http
      scheme: bearer

```