---
title: "Triggers a new Execution for the Flow"
method: POST
path: "/v2/Flows/{FlowSid}/Executions"
tags: ["StudioV2Execution"]
---

# Triggers a new Execution for the Flow

`POST /v2/Flows/{FlowSid}/Executions`

Triggers a new Execution for the Flow

## Path parameters

- `FlowSid` string, required

## Response `201`

Created

- StudioV2FlowExecution
  - `sid` string, nullable — The unique string that we created to identify the Execution resource.
  - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Execution resource.
  - `flow_sid` string, nullable — The SID of the Flow.
  - `contact_channel_address` string, nullable — 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`.
  - `contact_sid` string, nullable — The SID of the Contact.
  - `flow_version` integer, nullable — The Flow version number at the time of Execution creation.
  - `context` unknown
  - `status` 'active' | 'ended' — The status of the Execution. Can be: `active` or `ended`.
  - `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.
  - `initiated_by` string, nullable — The SID or identifier that triggered this Execution. For example, a Call SID if triggered by an incoming call, a Message SID if triggered by an incoming message, a Request SID if triggered by a REST API request, and so on.
  - `url` string, uri, nullable — The absolute URL of the resource.
  - `links` object, nullable — The URLs of nested resources.

## Changes

- **2026-04-14** (v2) `c52cffd90425` — 1 info
  - added the optional property `initiated_by` to the response with the `201` status
- **2026-03-24** (v2) `cbcd35943890` — 2 info
  - added the optional property `contact_sid` to the response with the `201` status
  - added the optional property `flow_version` to the response with the `201` status
- **2025-07-03** (v2) `88ca5d3cb0bb` — 1 breaking, 1 info
  - the `context` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - the `Parameters` request property type/format was generalized from `object`/`` to ``/``
- **2025-03-11** (v2) `d6e7767d27a5` — 2 breaking
  - the `Parameters` request property type/format changed from ``/`` to `object`/``
  - the `context` response's property type/format changed from ``/`` to `object`/`` for status `201`
- **2023-08-10** (v2) `531843bd1ac8` — 1 info
  - api tag `StudioV2Execution` added

[Change history](https://skmtc.dev/twilio/apis/twilio-studio/changes/v2/Flows/:FlowSid/Executions/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)
