# Create flex flow

**POST /v1/FlexFlows**


Flex Flow

## Servers



## Parameters



### Body:  (object)

- **ChannelType** (string)
  The channel type. One of `web`, `facebook`, `sms`, `whatsapp`, `line` or `custom`. By default, Studio’s Send to Flex widget passes it on to the Task attributes for Tasks created based on this Flex Flow. The Task attributes will be used by the Flex UI to render the respective Task as appropriate (applying channel-specific design and length limits). If `channelType` is `facebook`, `whatsapp` or `line`, the Send to Flex widget should set the Task Channel to Programmable Chat.
- **ChatServiceSid** (string)
  The SID of the chat service.
- **ContactIdentity** (string)
  The channel contact's Identity.
- **Enabled** (boolean)
  Whether the new Flex Flow is enabled.
- **FriendlyName** (string)
  A descriptive string that you create to describe the Flex Flow resource.
- **Integration.Channel** (string)
  The Task Channel SID (TCXXXX) or unique name (e.g., `sms`) to use for the Task that will be created. Applicable and required when `integrationType` is `task`. The default value is `default`.
- **Integration.CreationOnMessage** (boolean)
  In the context of outbound messaging, defines whether to create a Task immediately (and therefore reserve the conversation to current agent), or delay Task creation until the customer sends the first response. Set to false to create immediately, true to delay Task creation. This setting is only applicable for outbound messaging.
- **Integration.FlowSid** (string)
  The SID of the Studio Flow. Required when `integrationType` is `studio`.
- **Integration.Priority** (integer)
  The Task priority of a new Task. The default priority is 0. Optional when `integrationType` is `task`, not applicable otherwise.
- **Integration.RetryCount** (integer)
  The number of times to retry the Studio Flow or webhook in case of failure. Takes integer values from 0 to 3 with the default being 3. Optional when `integrationType` is `studio` or `external`, not applicable otherwise.
- **Integration.Timeout** (integer)
  The Task timeout in seconds for a new Task. Default is 86,400 seconds (24 hours). Optional when `integrationType` is `task`, not applicable otherwise.
- **Integration.Url** (string(uri))
  The URL of the external webhook. Required when `integrationType` is `external`.
- **Integration.WorkflowSid** (string)
  The Workflow SID for a new Task. Required when `integrationType` is `task`.
- **Integration.WorkspaceSid** (string)
  The Workspace SID for a new Task. Required when `integrationType` is `task`.
- **IntegrationType** (string)
  The software that will handle inbound messages. [Integration Type](https://www.twilio.com/docs/flex/developer/messaging/manage-flows#integration-types) can be: `studio`, `external`, or `task`.
- **JanitorEnabled** (boolean)
  When enabled, the Messaging Channel Janitor will remove active Proxy sessions if the associated Task is deleted outside of the Flex UI. Defaults to `false`.
- **LongLived** (boolean)
  When enabled, Flex will keep the chat channel active so that it may be used for subsequent interactions with a contact identity. Defaults to `false`.


## Responses
### 201
Created

#### Body:  (object)
- **account_sid** (string | null)
  The SID of the Account that created the resource
- **channel_type** (string | null)
  The channel type
- **chat_service_sid** (string | null)
  The SID of the chat service
- **contact_identity** (string | null)
  The channel contact's Identity
- **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
- **enabled** (boolean | null)
  Whether the Flex Flow is enabled
- **friendly_name** (string | null)
  The string that you assigned to describe the resource
- **integration** ()
  An object that contains specific parameters for the integration
- **integration_type** (string | null)
  The software that will handle inbound messages.
- **janitor_enabled** (boolean | null)
  Remove active Proxy sessions if the corresponding Task is deleted.
- **long_lived** (boolean | null)
  Re-use this chat channel for future interactions with a contact
- **sid** (string | null)
  The unique string that identifies the resource
- **url** (string(uri) | null)
  The absolute URL of the Flex Flow resource


[Powered by Bump.sh](https://bump.sh)