---
title: "Create a new Custom Object instance"
method: POST
path: "/custom_object/"
tags: ["custom_objects"]
---

# Create a new Custom Object instance

`POST /custom_object/`

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

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.

## Response `201`

Successful response

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/close/apis/close-api.md) · [All operations](https://skmtc.net/close/apis/close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/close/close-api/revisions/0dcf3303e9d7/schema)