---
title: "PUT /objects/{object_name}/records"
method: PUT
path: "/objects/{object_name}/records"
tags: ["Object Records"]
---

# PUT /objects/{object_name}/records

`PUT /objects/{object_name}/records`

## Path parameters

- `object_name` string, required

## Request body

- UpsertRecordRequest — Request body for upserting a record.
  - `match` object, required — The attribute values to match against to find an existing record.
  - `create` object — The attribute values to use when creating a new record if no match is found.
  - `update` object — The attribute values to use when updating an existing record if a match is found.
  - `defaults` object — Default attribute values to apply during both creation and update operations.

## Response `200`

Response for a successful update operation.

- object — Response for a successful update operation.
  - `status` 'success', required
  - `data` object, required
    - `object` string, required — The API name of the object this record is an instance of.
    - `id` string, required — String UUIDv4 value.
    - `created_at` string, date-time, required — Date and time the record was created.
    - `updated_at` string, date-time, required — Date and time the record was last updated.
    - `attributes` object, required — Attribute values for the record. Each key is the API name of the attribute and each value is the corresponding attribute value for the record.

## Other responses

- `400` — Response for any operation that results in a bad request error.
- `401` — Response for any operation that results in an unauthorized error.
- `404` — Response for any operation that results in a not found error.
- `500` — Response for any operation that results in an internal server error.

---

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