---
title: "Create an entry (add record to list)"
method: POST
path: "/v2/lists/{list}/entries"
tags: ["Entries"]
---

# Create an entry (add record to list)

`POST /v2/lists/{list}/entries`

Adds a record to a list as a new list entry. This endpoint will throw on conflicts of unique attributes. Multiple list entries are allowed for the same parent record

Required scopes: `list_entry:read-write`, `list_configuration:read`.

## Path parameters

- `list` string, required — The UUID or slug identifying the list that the created list entry should belong to.

## Request body

- object
  - `data` object, required
    - `parent_record_id` string, uuid, required — A UUID identifying the record you want to add to the list. The record will become the 'parent' of the created list entry.
    - `parent_object` string, required — A UUID or slug identifying the object that the added parent record belongs to.
    - `entry_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 entry belongs to.
      - `list_id` string, uuid, required — A UUID identifying the list this entry is in.
      - `entry_id` string, uuid, required — A UUID identifying this entry.
    - `parent_record_id` string, uuid, required — A UUID identifying the record that is parent of the list entry.
    - `parent_object` string, required — A UUID or slug identifying the object that the parent record belongs to.
    - `created_at` string, required — When this entry was created.
    - `entry_values` object, required — A list of attribute values for the list entry (not attribute values for its parent record).

## Other responses

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

## Changes

> 16 revisions in range; 2 could not be searched.

- **2026-08-15** `ab325846bdb6` — 1 warning
  - added the new `EGP` enum value to the `data/entry_values/additionalProperties/items/oneOf[subschema #3]/currency_code` response property for the response status `200`
- **2026-08-12** `47425e632e9a` — 3 warning
  - added the new `GHS` enum value to the `data/entry_values/additionalProperties/items/oneOf[subschema #3]/currency_code` response property for the response status `200`
  - added the new `OMR` enum value to the `data/entry_values/additionalProperties/items/oneOf[subschema #3]/currency_code` response property for the response status `200`
  - added the new `QAR` enum value to the `data/entry_values/additionalProperties/items/oneOf[subschema #3]/currency_code` response property for the response status `200`
- **2026-07-26** `0eb6da8a7a07` — 1 warning
  - added the new `IDR` enum value to the `data/entry_values/additionalProperties/items/oneOf[subschema #3]/currency_code` response property for the response status `200`

[Change history](https://skmtc.dev/attio/apis/attio-api/changes/v2/lists/:list/entries/post.md)

---

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