---
title: "Create CRM entity item"
method: POST
path: "/crm/v1/entities/{entity}"
tags: ["items"]
---

# Create CRM entity item

`POST /crm/v1/entities/{entity}`

Creates a new CRM entity item (lead, deal, contact, or company).
Example: `POST /crm/v1/entities/leads`

## Request body

- CreateCrmEntity
  - `title` string
  - `owner` integer
  - `source` string
  - `funnel_id` integer
  - `email` object[]
    - `id` string
    - `type` string
    - `value` string
    - `main` boolean
  - `phone` object[]
    - `id` string
    - `type` 'WORK' | 'MOBILE' | 'HOME'
    - `value` string
    - `code` string
  - `messengers` object[]
    - `id` string
    - `type` string
    - `link` string

## Response `201`

Created

- object
  - `title` string
  - `owner` integer
  - `created_by` integer
  - `changed_by` integer
  - `converted` boolean
  - `first_name` string
  - `last_name` string
  - `patronymic` string
  - `company_name` string
  - `position` string
  - `utm_source` string
  - `utm_medium` string
  - `utm_campaign` string
  - `utm_content` string
  - `utm_term` string
  - `source` SourceList
    - `title` string
    - `value` string
    - `color` string
    - `sort` integer
    - `selected` boolean
  - `email` object[]
    - `id` string
    - `type` string
    - `value` string
    - `main` boolean
  - `phone` object[]
    - `id` string
    - `type` 'WORK' | 'MOBILE' | 'HOME'
    - `value` string
    - `code` string
  - `messengers` object[]
    - `id` string
    - `type` string
    - `link` string
  - `kanban_status` string
  - `kanban_reason_id` integer
  - `kanban_stage_id` integer
  - `id` integer
  - `created_at` integer
  - `updated_at` integer

## Other responses

- `401` — Access token is missing or invalid
- `422` — Validation error response

---

[API](https://skmtc.net/uspacy/apis/crm-service-2.md) · [All operations](https://skmtc.net/uspacy/apis/crm-service-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uspacy/crm-service-2/revisions/f80578d43845/schema)