---
title: "Processes.create"
method: POST
path: "/entities/Processes"
tags: ["Process"]
---

# Processes.create

`POST /entities/Processes`

Creates new Process

## Query parameters

- `validation-level` integer

## Response `201`

Creation confirmation. Returns created Process

- object
  - `success` boolean — True when response succeeded, false on error.
  - `data` Process
    - `is_delete_protected` boolean, required — Tells if the entity instance is protected against delete (Entities that need to be present in the system at any time). Delete action still may fail if entity is deletable, due some other additional validations.
    - `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.
    - `owner` string, uri, required — User who owns the process. Relation to Client. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Client' object for properties.
    - `ai_conversation` object — AI assistant conversation associated with the process (e.g. records of AI-driven schema generation).
    - `deactivation_reason` 0 | 1 | 2 | 3 — Field whose values are strictly defined with an enumeration of values. Integer enum value: 0 - NoReason, 1 - Manual, 2 - TooManyErrors, 3 - DisabledFeature
    - `description` string — Free-text description shown alongside the process.
    - `is_enabled` boolean — When true, the process actively responds to its trigger; when false, the process is paused. Toggle via enable/disable mutations.
    - `last_schema_change` string, date-time — Timestamp of the most recent change to settings.
    - `last_status_change` string, date-time — Timestamp of the most recent change to is_enabled.
    - `name` string, required — Name of the entity and its default text representation.
    - `owner_id` string, uuid, required — Id of the owning user.
    - `settings` object — Process schema as a JSON object conforming to the ProcessSchema type — trigger, nodes and settings. Built via the process builder; validated on write. Full structure: https://graphql.api-doc.pipelinersales.com/latest/graphql/space/processschema.doc.html
    - `type` 1 | 2, required — Field whose values are strictly defined with an enumeration of values. Integer enum value: 1 - Personal, 2 - Space
    - `activity_logs` string[] — Activity log runs (one per process execution) recorded for this process.
    - `tags` string[] — Tags attached to the process for organisation/filtering.
    - `activity` object, required — Activity timeline for the last 24 hours showing per-hour counts of successful, warning, and error process runs.
    - `documents` string[] — Files attached to the process (e.g. process documentation).

## Other responses

- `500` — unexpected error

---

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