---
title: "POST /data/v1/objects/{object_name}/records"
method: POST
path: "/data/v1/objects/{object_name}/records"
tags: ["Data", "Object Records"]
---

# POST /data/v1/objects/{object_name}/records

`POST /data/v1/objects/{object_name}/records`

## Path parameters

- `object_name` string, required

## Query parameters

- `validation_mode` 'strict' | 'ignore_invalid' — Validation mode to use when validating request data. `strict` validation will fail requests if any attribute fails validation, including unrecognized attributes. `ignore_invalid` validation will strip out unknown attributes and replace known, non-required attributes with `undefined` if they fail validation. The request will still fail if the request body does not contain the proper structure or if any required attributes fail validation.

## Request body

- DataCreateRecordRequest — Request body for creating a record.
  - `data` UObjectsURecordAttributes, required — Attribute key-value pairs associated with an object record.

## Response `201`

Response for a successful create operation.

- object — Response for a successful create operation.
  - `status` 'success', required
  - `data` UObjectsURecord, required — Object record with its associated metadata and attribute key-value pairs.
    - `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` UObjectsURecordAttributes, required — Attribute key-value pairs associated with an object 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.
- `409` — Response for any operation that results in a conflict error.
- `500` — Response for any operation that results in an internal server error.
- `503` — Response for any operation that results in service unavailability.

## Changes

- **2026-04-22** `17c3b84a9890` — 1 breaking, 1 warning, 3 info
  - the request property `data/allOf[#/components/schemas/UObjects.URecordAttributes]/additionalProperties/` became not nullable
  - removed `#/components/schemas/UValues.UValue` from the `data/allOf[#/components/schemas/UObjects.URecordAttributes]/additionalProperties/` request property `allOf` list
  - added `subschema #1, subschema #2` to the `data/allOf[#/components/schemas/UObjects.URecordAttributes]/additionalProperties/` request property `anyOf` list
  - removed `#/components/schemas/UValues.UValue` from the `data/attributes/allOf[#/components/schemas/UObjects.URecordAttributes]/additionalProperties/` response property `allOf` list for the response status `201`
  - …1 more
- **2026-04-22** `3bc5202f7ff0` — 3 breaking, 1 info
  - added `#/components/schemas/UObjects.URecordAttributes` to the `data` request property `allOf` list
  - the `data` request property type/format changed from `object`/`` to ``/``
  - the `data/attributes` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - added `#/components/schemas/UObjects.URecordAttributes` to the `data/attributes` response property `allOf` list for the response status `201`
- …earlier changes not shown

[Full history](https://skmtc.dev/unifygtm/apis/unify-api/changes/data/v1/objects/:object_name/records/post.md)

---

[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/832b8061b7a4/schema)