# Create flow version

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

Create a new version of an existing flow in the connected Salesforce org.
Use get_flow_version to fetch an existing version's metadata as a starting
point, then modify and pass it here. Returns the id (DurableId) of the
newly created version.

To update an existing draft version use update_flow_version. To activate
or deactivate a version use activate_flow_version or deactivate_flow_version.

## Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| crm_connection_id | string | yes | UUID of the CRM connection |
| flow_id | string | yes | DurableId of the flow definition |

## Request body

`application/json`

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| metadata | object | yes | Complete flow metadata object. Fetch the current metadata via get_flow_version first, modify what you need, then submit the full object — not just the changed fields. |

## Response

`201 Created` — `application/json`

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

## Errors

| Status | Description |
|--------|-------------|
| 400 | Bad Request |
| 403 | Forbidden |
| 404 | Not Found |
| 422 | Unprocessable Entity |
| 502 | Bad Gateway |