POST /v2/Flows
Account sid auth token

Studio flows

Create a Flow.

application/x-www-form-urlencoded

Body

  • CommitMessage string

    Description of change made in the revision.

  • Definition Required

    JSON representation of flow definition.

  • FriendlyName string Required

    The string that you assigned to describe the Flow.

  • Status string Required

    The status of the Flow. Can be: draft or published.

    Values are draft or published.

Responses

  • 201 application/json

    Created

    Hide response attributes Show response attributes object
    • account_sid string | null

      The SID of the Account that created the resource

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

    • commit_message string | null

      Description of change made in the revision

    • date_created string(date-time) | null

      The ISO 8601 date and time in GMT when the resource was created

    • date_updated string(date-time) | null

      The ISO 8601 date and time in GMT when the resource was last updated

    • definition

      JSON representation of flow definition

    • errors array | null

      List of error in the flow definition

    • friendly_name string | null

      The string that you assigned to describe the Flow

    • links object(uri-map) | null

      Nested resource URLs

    • revision integer | null

      The latest revision number of the Flow's definition

    • sid string | null

      The unique string that identifies the resource

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^FW[0-9a-fA-F]{32}$.

    • status string | null

      The status of the Flow

      Values are draft or published.

    • url string(uri) | null

      The absolute URL of the resource

    • valid boolean | null

      Boolean if the flow definition is valid

    • warnings array | null

      List of warnings in the flow definition

    • webhook_url string(uri) | null
POST /v2/Flows 
curl \
 --request POST 'https://studio.twilio.com/v2/Flows' \
 --user "username:password" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'CommitMessage=string&FriendlyName=string&Status=draft'
Response examples (201) 
{
  "account_sid": "string",
  "commit_message": "string",
  "date_created": "2026-05-04T09:42:00Z",
  "date_updated": "2026-05-04T09:42:00Z",
  "errors": [],
  "friendly_name": "string",
  "links": {},
  "revision": 42,
  "sid": "string",
  "status": "draft",
  "url": "https://example.com",
  "valid": true,
  "warnings": [],
  "webhook_url": "https://example.com"
}