---
title: "Create a Flow."
method: POST
path: "/v2/Flows"
tags: ["StudioV2Flow"]
---

# Create a Flow.

`POST /v2/Flows`

Create a Flow.

## Response `201`

Created

- StudioV2Flow
  - `sid` string, nullable — The unique string that we created to identify the Flow resource.
  - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Flow resource.
  - `author_sid` string, nullable — The SID of the User that created or last updated the Flow.
  - `friendly_name` string, nullable — The string that you assigned to describe the Flow.
  - `definition` unknown
  - `status` 'draft' | 'published' — The status of the Flow. Can be: `draft` or `published`.
  - `revision` integer — The latest revision number of the Flow's definition.
  - `commit_message` string, nullable — Description of change made in the revision.
  - `valid` boolean, nullable — Boolean if the flow definition is valid.
  - `errors` unknown[], nullable — List of error in the flow definition.
    - unknown
  - `warnings` unknown[], nullable — List of warnings in the flow definition.
    - unknown
  - `date_created` string, date-time, nullable — The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `date_updated` string, date-time, nullable — The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `webhook_url` string, uri, nullable
  - `url` string, uri, nullable — The absolute URL of the resource.
  - `links` object, nullable — The URLs of the Flow's nested resources.

## Changes

- **2026-05-06** (v2) `c384dd0ef331` — 1 info
  - added the new optional request property `AuthorSid`
- **2026-03-24** (v2) `cbcd35943890` — 1 info
  - added the optional property `author_sid` to the response with the `201` status
- **2025-07-03** (v2) `88ca5d3cb0bb` — 3 breaking, 1 info
  - the `definition` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - the `errors/items/` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - the `warnings/items/` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - the `Definition` request property type/format was generalized from `object`/`` to ``/``
- **2025-03-11** (v2) `d6e7767d27a5` — 4 breaking
  - the `Definition` request property type/format changed from ``/`` to `object`/``
  - the `definition` response's property type/format changed from ``/`` to `object`/`` for status `201`
  - the `errors/items/` response's property type/format changed from ``/`` to `object`/`` for status `201`
  - the `warnings/items/` response's property type/format changed from ``/`` to `object`/`` for status `201`
- **2024-08-26** (v2) `20f88e4a96ce` — 1 info
  - the `revision` response's property default value `0` was added for the status `201`

[Full history](https://skmtc.dev/twilio/apis/twilio-studio/changes/v2/Flows/post.md)

---

[API](https://skmtc.dev/twilio/apis/twilio-studio.md) · [All operations](https://skmtc.dev/twilio/apis/twilio-studio/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/twilio-studio/revisions/c384dd0ef331/schema)