# Triggers a new Execution for the Flow

**POST /v1/Flows/{FlowSid}/Executions**

Triggers a new Execution for the Flow
Executions of Studio flows

## Servers
- https://studio.twilio.com: https://studio.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **FlowSid** (string)
  The SID of the Excecution's Flow.


### Body: application/x-www-form-urlencoded (object)

- **To** (string(phone-number))
  The Contact phone number to start a Studio Flow Execution, available as variable `{{contact.channel.address}}`.
- **From** (string(phone-number))
  The Twilio phone number to send messages or initiate calls from during the Flow's Execution. Available as variable `{{flow.channel.address}}`. For SMS, this can also be a Messaging Service SID.
- **Parameters** ()
  JSON data that will be added to the Flow's context and that can be accessed as variables inside your Flow. For example, if you pass in `Parameters={"name":"Zeke"}`, a widget in your Flow can reference the variable `{{flow.data.name}}`, which returns "Zeke". Note: the JSON value must explicitly be passed as a string, not as a hash object. Depending on your particular HTTP library, you may need to add quotes or URL encode the JSON string.


## Responses
### 200
OK
#### Headers
- **Access-Control-Allow-Origin** (string)
  Specify the origin(s) allowed to access the resource
- **Access-Control-Allow-Methods** (string)
  Specify the HTTP methods allowed when accessing the resource
- **Access-Control-Allow-Headers** (string)
  Specify the headers allowed when accessing the resource
- **Access-Control-Allow-Credentials** (boolean)
  Indicates whether the browser should include credentials
- **Access-Control-Expose-Headers** (string)
  Headers exposed to the client

#### Body: application/json (object)
- **sid** (string | null)
  The unique string that we created to identify the Execution resource.
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Execution resource.
- **flow_sid** (string | null)
  The SID of the Flow.
- **contact_sid** (string | null)
  The SID of the Contact.
- **contact_channel_address** (string | null)
  The phone number, SIP address or Client identifier that triggered the Execution. Phone numbers are in E.164 format (e.g. +16175551212). SIP addresses are formatted as `name@company.com`. Client identifiers are formatted `client:name`.
- **context** ()
  The current state of the Flow's Execution. As a flow executes, we save its state in this context. We save data that your widgets can access as variables in configuration fields or in text areas as variable substitution.
- **status** (string)
  The status of the Execution. Can be: `active` or `ended`.
- **date_created** (string(date-time) | null)
  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) | null)
  The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
- **url** (string(uri) | null)
  The absolute URL of the resource.
- **links** (object(uri-map) | null)
  The URLs of nested resources.


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