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

# POST /objects/{object_name}/records

`POST /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

- CreateRecordRequest — Request body for creating a record.
  - `data` object, required — The attribute values for the new record. All required attributes on the object must be included.

## Response `201`

Response for a successful create operation.

- object — Response for a successful create 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.
- `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.

---

[API](https://skmtc.net/unifygtm/apis/unify-analytics-api.md) · [All operations](https://skmtc.net/unifygtm/apis/unify-analytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unifygtm/unify-analytics-api/versions/2f145e6f6d7e/schema)