---
title: "Update a custom object record"
method: PUT
path: "/objects/records/default/{object}/{id}"
tags: ["Custom Object Records"]
---

# Update a custom object record

`PUT /objects/records/default/{object}/{id}`

Updates a record of the given type and ID.

### Limitations

* 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
- `id` string, uuid, required

## Headers

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

## Request body

- CustomObjectRecordWithOnlyCustomFields

## Response `200`

OK

- 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.

## Other responses

- `404` — Object record does not exist

---

[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)