---
title: "SalesUnits.create"
method: POST
path: "/entities/SalesUnits"
tags: ["SalesUnit"]
---

# SalesUnits.create

`POST /entities/SalesUnits`

## Request

- Base URL: `https://us-east.api.coevera.com/api/v100/rest/spaces/your_space_id`
- URL: `https://us-east.api.coevera.com/api/v100/rest/spaces/your_space_id/entities/SalesUnits`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/coevera/apis/coevera-crm-api/docs/entities/SalesUnits/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a SalesUnit record.

## Query parameters

- `validation-level` integer

## Request body

- CreateSalesUnitInput: Field values of a new SalesUnit record.
  - `modified` string, date-time: Last modification time.
  - `created` string, date-time: Creation time.
  - `picture` object: Profile picture (logo) of the sales unit. Related CloudObject record; see 'createCloudObjectInput' for its fields.
    - `id` string, uuid: Id of the related CloudObject record.
  - `name` string, required: Name of the entity and its default text representation.
  - `parent_id` string, uuid: Id of the parent unit, or empty for the root unit.
  - `picture_id` string, uuid: Id of the picture cloud object.
  - `revision` integer: Revision when entity was lastly changed.

## Response `201`

The created SalesUnit record.

- object
  - `success` boolean: True when the request succeeded; false on error.
  - `data` SalesUnit: Sales unit (team) in the organization hierarchy that users belong to.
    - `is_delete_protected` boolean, required: True when the record is protected against deletion because it must always exist in the space. Deleting a record that is not protected can still fail on other checks. Read-only.
    - `id` string, uuid, required: Unique identifier of entity.
    - `is_deleted` boolean: Specifies if the entity is considered deleted.
    - `modified` string, date-time: Last modification time.
    - `created` string, date-time: Creation time.
    - `parent` string, uri: Parent sales unit, when this unit is nested. Empty for the root unit. Related SalesUnit record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'SalesUnit' for its fields.
    - `picture` string, uri: Profile picture (logo) of the sales unit. Related CloudObject record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'CloudObject' for its fields.
    - `name` string, required: Name of the entity and its default text representation.
    - `parent_id` string, uuid: Id of the parent unit, or empty for the root unit.
    - `picture_id` string, uuid: Id of the picture cloud object.
    - `revision` integer: Revision when entity was lastly changed.

## Other responses

- `400`: Bad request: a bad or unknown parameter (codes 117, 118), a missing permission (code 50), conflicting data (code 2002) or any other API error. The REST API answers 400 where others answer 403 or 409; check `code`.
- `401`: Not authenticated: missing or wrong credentials, a credential of another space, or an expired token (code 401, ERROR_UNAUTHORIZED).
- `422`: Validation failed (code 40000, with the failing fields) or a required parameter is missing (code 119). By default one failed item fails a whole batch and nothing is written.
- `429`: Too many requests (code 182). Wait for the seconds in Retry-After, then retry.
- `500`: Unexpected server error (code 1000, ERROR_UNKNOWN).

---

[API](https://skmtc.dev/coevera/apis/coevera-crm-api.md) - [All operations](https://skmtc.dev/coevera/apis/coevera-crm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coevera/apis/coevera-crm-api/revisions/40ebbc83f179?raw)