---
search:
  tags:
    - Approvals
    - POST
seo:
  description: >-
    A definition names the stages a record passes through and who approves…
    Reference for the POST /api/v1/approval-definitions endpoint in the Taylorz
    CRM API.
sidebar:
  label: Create an approval definition
  badge: POST
title: Create an approval definition
type: openapi-operation
---
A definition names the stages a record passes through and who approves each one.

`POST /api/v1/approval-definitions`

**Request body** (`application/json`, required)

- `label` (string, required)
- `stages` (object[], required)
- `objectId` (string, required)
- `version` (integer)

Request body example:

```json
{
  "label": "string",
  "stages": [
    {
      "approverUserId": "string",
      "label": "string"
    }
  ],
  "objectId": "string",
  "version": 1
}
```

**Responses**

- `201` — The definition was created
- `400` — The request body, query or parameters were refused
- `401` — The access token is missing, invalid or revoked
- `403` — The tenant's module is off, or the token's scope or the member's role does not permit the action
- `404` — No such record, or none the caller may read
- `409` — The operation conflicts with the current state
- `413` — The request exceeds the route's body limit
- `500` — An unexpected failure

Response example, 201:

```json
{
  "id": "string"
}
```