---
title: "Create custom object records"
method: POST
path: "/objects/records/default/{object}"
tags: ["Custom Object Records"]
---

# Create custom object records

`POST /objects/records/default/{object}`

Creates custom object records with the given type.

Upon creating records of a custom object type, the 200 response contains a list of records that have been successfully processed and stored.

### Limitations

This call has the following limitations:
  
* The maximum number of records that you can create by one call is 1,000.
* The storage of empty strings in records is not supported.
* Null values must be formatted as the following example:
  ```
  {
    "records": [
      {
        "fieldName__c": null
      }
    ]
  }
  ```
* When creating or updating custom object records with relationship-type fields, Zuora verifies the related objects against the transactional databases, which are updated in near real-time. The record creation or modification fails upon unsuccessful verifications. <br />If the related objects are newly created in your tenant, it might need some time for the transactional database synchronization.

## Path parameters

- `object` string, required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string, date

## Request body

- PostCustomObjectRecordsRequest
  - `allowPartialSuccess` boolean — Indicates whether the records that pass the schema validation should be created when not all records in the request pass the schema validation.
  - `records` CustomObjectRecordWithOnlyCustomFields[], required — A list of custom object records to be created

## Response `200`

OK

The 200 response indicates that the records have been partially or completely created.

* If the `allowPartialSuccess` flag is set to `false`, the 200 response indicates that all object records have been successfully created.
* If the `allowPartialSuccess` flag is set to `true`, the 200 response indicates that some records might not be succesffully created and the error information might be contained in the response body.

- PostCustomObjectRecordsResponse
  - `error` CustomObjectRecordsErrorResponse
    - `code` integer
    - `details` CustomObjectRecordsWithError[]
      - `code` 71012520 | 71012521 | 71012522 | 71012523 | 71012524 | 71012525 | 71012526 | 71012530 — See <a href="https://docs.zuora.com/en/zuora-platform/extensibility/custom-objects/custom-objects-api/custom-objects-api-error-code" target="_blank">Custom Objects API error code</a> for details.
      - `message` string
      - `record` CustomObjectRecordWithAllFields — Record data from an object
        - `CreatedById` string — The creator's Id
        - `CreatedDate` string, date-time — The record creation time in the date-time format
        - `Id` string, uuid — The unique Id of the custom object record
        - `UpdatedById` string — The modifier's Id
        - `UpdatedDate` string, date-time — The record modification time in the date-time format
        - `type` string — The type of the custom object record. It is the API name of the custom object definition.
    - `message` string
  - `records` CustomObjectRecordWithAllFields[] — The custom object records that are succesfully created and stored
    - `CreatedById` string — The creator's Id
    - `CreatedDate` string, date-time — The record creation time in the date-time format
    - `Id` string, uuid — The unique Id of the custom object record
    - `UpdatedById` string — The modifier's Id
    - `UpdatedDate` string, date-time — The record modification time in the date-time format
    - `type` string — The type of the custom object record. It is the API name of the custom object definition.

## Other responses

- `400` — Failed schema validation
- `401` — Unauthorized
- `500` — Internal error. Retry the returned records.

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)