---
title: "Create a status"
method: POST
path: "/v2/{target}/{identifier}/attributes/{attribute}/statuses"
tags: ["Attributes"]
---

# Create a status

`POST /v2/{target}/{identifier}/attributes/{attribute}/statuses`

Add a new status to a status attribute on either an object or a list.

When `target` is `objects`, the required scopes are `object_configuration:read-write`. When `target` is `lists`, the required scopes are `list_configuration:read-write`.

## Path parameters

- `target` 'lists' | 'objects', required — Whether the attribute is on an object or a list.
- `identifier` string, required — A UUID or slug to identify the object or list the status attribute belongs to.
- `attribute` string, required — A UUID or slug to identify the attribute the status will belong to.

## Request body

- object
  - `data` object, required
    - `title` string, required — The Title of the status
    - `celebration_enabled` boolean — Whether arriving at this status triggers a celebration effect
    - `target_time_in_status` string, nullable — Target time for a record to spend in given status expressed as a ISO-8601 duration string

## Response `200`

Success

- object — Success
  - `data` Status, required
    - `id` object, required
      - `workspace_id` string, uuid, required — The ID of the workspace
      - `object_id` string, uuid, required — The ID of the object
      - `attribute_id` string, uuid, required — The ID of the attribute
      - `status_id` string, uuid, required — The ID of the status
    - `title` string, required — The title of the status
    - `is_archived` boolean, required — Whether or not to archive the status. See our [archiving guide](/docs/archiving-vs-deleting) for more information on archiving.
    - `celebration_enabled` boolean, required — Whether arriving at this status triggers a celebration effect in the UI
    - `target_time_in_status` string, nullable, required — Target time for a record to spend in given status expressed as a ISO-8601 duration string

## Other responses

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

---

[API](https://skmtc.net/attio/apis/attio-api.md) · [All operations](https://skmtc.net/attio/apis/attio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attio/attio-api/versions/40a8e41d06a2/schema)