# Create flow

`POST` `/api/v1/crm-connections/{crm_connection_id}/flows`

Create a new flow in the connected Salesforce org. The new flow is created
with Draft status. Returns the DurableId of the created flow. The API name
must be unique across the org.

## Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| crm_connection_id | string | yes | UUID of the CRM connection |

## Request body

`application/json`

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| full_name | string | yes | Unique API name for the flow. Must start with a letter and contain only letters, digits, and underscores. Must not end with an underscore or contain consecutive underscores. |
| label | string | yes | Display label for the flow. |
| process_type | string | yes | Type of flow to create (e.g. AutoLaunchedFlow, Flow). Determines the flow's runtime behavior and available elements. |
| description | string | no | Description of the flow. |
| api_version | number | no | API version for the flow's execution behavior. Defaults to the org's current API version if omitted. |
| metadata | object | no | Additional flow metadata fields (e.g. elements, variables, formulas). Merged into the base metadata sent to Salesforce. |

## Response

`201 Created` — `application/json`

| Field | Type | Description |
|-------|------|-------------|
| id | string | DurableId of the newly created flow definition |

## Errors

| Status | Description |
|--------|-------------|
| 400 | Bad Request |
| 403 | Forbidden |
| 409 | Conflict |
| 422 | Unprocessable Entity |
| 502 | Bad Gateway |