---
title: "Service: /members/{member}/groups/{group}/uris/{uri}/workflow [POST]"
source: https://dev.pageseeder.com/api/services/create-uri-workflow-POST.html
description: "Create a new workflow"
last_updated: 2026-08-07T17:09:54+10:00
document_type: api_endpoint
operation_id: uri-POST
resource_id: uri
path_template: /members/{member}/groups/{group}/uris/{uri}/workflow
http_method: POST
api_category: uri
implementation_version: null
api_since: null
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: N/A
generated_at: 2026-08-07
tokens: ~685
---

# /members/\{member\}/groups/\{group\}/uris/\{uri\}/workflow \[POST\]

## Description

Create a new workflow.

Adds a workflow step to a URI, or if the URI is a folder, the URIs under it.

If the URI is a folder, this service starts an [asynchronous process](../usage/asynchronous_process.md).

> **Note:** Workflow tasks might not be available in groups a document is shared to unless they were created after the document was shared.

## Parameters

| Name | Description | Required | Type | Default value |
| --- | --- | --- | --- | --- |
| assignedto | `ID` of assigned member for workflow (`""` means blank value) | no | string | *previous workflow assigned member* |
| description | The workflow content | no | string |  |
| draft | Whether the workflow is a draft. | no | boolean | `false` |
| due | The workflow due date and time in ISO-8601 format. e.g. `2010-10-25T18:00:00+11:00` (`""` means blank value) | no | datetime | *previous workflow due date* |
| labels | Label values for workflow e.g. Important, Typo | no | string |  |
| notify | Send notification flag `[silent\|minimal\|normal\|announce]` | no | notify | `silent` |
| notify-async | Whether emails should be sent asynchronously (for slow email servers) | no | boolean | `false` |
| priority | Priority for workflow e.g. `High`, `Medium`, `Low` (`""` means blank value) | no | string | *previous workflow priority* |
| status | Status for workflow e.g.`Initiated` , `In Progress`, `Complete`, `Approved`, `Suspended`, `Terminated` (required if URI is a folder or for first workflow) | maybe | string | *previous workflow status* |

## Permission

Requires contributor or higher in the group.

## Response

```lang-xml

<workflow-creation [warning="[warning]"]
                   [notify-param-ignored=true"]>
  <comment id="123"
           contentrole="Workflow"
           created="2012-03-08T12:34:00+10:00"
           status="Initiated"
           due="2012-03-10T18:00:00+10:00"
           priority="High">
    <title>Cavern stolen!</title>
    <author email="alibaba@fortythieves.com.au"> ...
    </author>
    <assignedto id="123"
                date="2012-03-09T..."> ...
    </assignedto>
    <content id="789"
             type="text/plain">Please review the treasure.
    </content>
  </comment>
</workflow-creation> 
```

For a single URI and the following XML for a folder URI.

```lang-xml

<workflow-creation>
  <thread ...> ... </thread>
</workflow-creation> 
```

## Error Handling

| Code | Cause / Description |
| --- | --- |
| 0x120E | The due date is invalid |
| 0x1027 | The assignedto Member ID is invalid |
| 0x122E | The labels parameter is invalid |
| 0x122F | The priority parameter is invalid |
| 0x1230 | The status parameter is invalid |