---
title: "Create a record"
method: POST
path: "/v2/objects/{object}/records"
tags: ["Records"]
---

# Create a record

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

Creates a new person, company or other record. This endpoint will throw on conflicts of unique attributes. If you would prefer to update records on conflicts, please use the [Assert record endpoint](/reference/put_v2-objects-object-records) instead.

Required scopes: `record_permission:read-write`, `object_configuration:read`.

## Path parameters

- `object` string, required — The UUID or slug identifying the object the created record should belong to.

## Request body

- object
  - `data` object, required
    - `values` object, required — An object with an attribute `api_slug` or `attribute_id` as the key, and a single value (for single-select attributes), or an array of values (for single or multi-select attributes) as the values. For complete documentation on values for all attribute types, please see our [attribute type docs](/docs/attribute-types).

## Response `200`

Success

- object — Success
  - `data` object, required
    - `id` object, required
      - `workspace_id` string, uuid, required — A UUID identifying the workspace this record belongs to.
      - `object_id` string, uuid, required — A UUID identifying the object this record belongs to.
      - `record_id` string, uuid, required — A UUID identifying this record.
    - `created_at` string, required — When this record was created.
    - `values` object, required — A record type with an attribute `api_slug` as the key, and an array of value objects as the values.

## Other responses

- `400` — Bad Request
- `404` — Not Found

## Changes

- **2025-04-24** `d2afbdc49fbc` — 1 warning
  - added the new `missing_value` enum value to the `code` response property for the response status `400`
- **2025-04-24** `4ce2c28668d4` — 1 info
  - the endpoint scheme security `oauth2` was removed from the API

[Change history](https://skmtc.dev/d-stoll/apis/attio-api/changes/v2/objects/:object/records/post.md)

---

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