---
title: "POST /v1/Workspaces/{WorkspaceSid}/Workflows"
method: POST
path: "/v1/Workspaces/{WorkspaceSid}/Workflows"
tags: ["TaskrouterV1Workflow"]
---

# POST /v1/Workspaces/{WorkspaceSid}/Workflows

`POST /v1/Workspaces/{WorkspaceSid}/Workflows`

## Path parameters

- `WorkspaceSid` string, required

## Response `201`

Created

- TaskrouterV1WorkspaceWorkflow
  - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Workflow resource.
  - `assignment_callback_url` string, uri, nullable — The URL that we call when a task managed by the Workflow is assigned to a Worker. See Assignment Callback URL for more information.
  - `configuration` string, nullable — A JSON string that contains the Workflow's configuration. See [Configuring Workflows](https://www.twilio.com/docs/taskrouter/workflow-configuration) for more information.
  - `date_created` string, date-time, nullable — The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
  - `date_updated` string, date-time, nullable — The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
  - `document_content_type` string, nullable — The MIME type of the document.
  - `fallback_assignment_callback_url` string, uri, nullable — The URL that we call when a call to the `assignment_callback_url` fails.
  - `friendly_name` string, nullable — The string that you assigned to describe the Workflow resource. For example, `Customer Support` or `2014 Election Campaign`.
  - `sid` string, nullable — The unique string that we created to identify the Workflow resource.
  - `task_reservation_timeout` integer — How long TaskRouter will wait for a confirmation response from your application after it assigns a Task to a Worker. Can be up to `86,400` (24 hours) and the default is `120`.
  - `workspace_sid` string, nullable — The SID of the Workspace that contains the Workflow.
  - `url` string, uri, nullable — The absolute URL of the Workflow resource.
  - `links` object, nullable — The URLs of related resources.

## Changes

- **2024-08-26** (v1) `98cb7b6f5a62` — 1 info
  - the `task_reservation_timeout` response's property default value `0` was added for the status `201`
- **2023-08-10** (v1) `0dff2919dfba` — 1 info
  - api tag `TaskrouterV1Workflow` added

[Change history](https://skmtc.dev/twilio/apis/taskrouter-v1/changes/v1/Workspaces/:WorkspaceSid/Workflows/post.md)

---

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