> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zixflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create A List Entry

> This endpoint creates a new entry in the specified list.

#### Description

This API endpoint allows the creation of a new entry within a specified list. The list entry is associated with a collection record, and additional data can be provided based on the attributes of the list.

#### Path

<ParamField path="listId" type="string" required>
  A unique identifier for the list where the new entry will be added.
</ParamField>

#### Body

<ParamField body="recordId" type="string" required>
  The ID of the collection record to be linked with the list entry.
</ParamField>

<ParamField body="data" type="object">
  Key-value pairs representing data for the list entry. Keys are defined by the attribute API key name, and values are based on the input type of the attribute.
</ParamField>

#### Response

<ResponseField name="status" type="boolean">
  Indicates the success or failure of the list entry creation. In this case,
  true signifies a successful operation.
</ResponseField>

<ResponseField name="message" type="string">
  Provides a human-readable message accompanying the response. In this instance,
  it confirms the successful creation of the list entry with the message "List entry created successfully!"
</ResponseField>

<ResponseField name="data" type="object">
  An object containing details of the created list entry. The structure of the data object is dynamic and depends on the attributes supported by the list:
</ResponseField>

<ResponseExample>
  ```json 200-Success theme={null}
  {
      "status": true,
      "message": "List entry created successfully!",
      "data": {
          "listId": "6551fdcad2d75edff28c9085",
          "peopleId": "654566f0c57bc82e28e5bb40",
          "companyId": null,
          "dealId": null,
          "recordId": null,
          "owner": "63d0e0b2eaa35b73f3b2344e",
          "_id": "6551fe0c92dc3d7c3aa20e12",
          "createdAt": "2023-11-13T10:44:28.028Z",
          "updatedAt": "2023-11-13T10:44:28.028Z",
          "__v": 0
          <!-- Additional fields based on list attributes -->
      }
  }
  ```

  ```json 401-Unauthorised theme={null}
  {
    "status": false,
    "message": "No token provided"
  }
  ```
</ResponseExample>
