---
schema_version: "1"
id: d446e72a23a7fa17a686c6be5fae730190d2709911f749d8cedd47f0803214e6
title: POST /hub/v1/workflowitems/{workflowItemId}/roles/{workflowRoleI...
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/createWorkflowTeamUser.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_workflowteams/createWorkflowTeamUser.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 88ba4b79fc804f8aa8357391cc1b74d6dc8e1482014b0e21654b5cbfab687e75
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# POST /hub/v1/workflowitems/{workflowItemId}/roles/{workflowRoleI...

Creates a user role to assign to a workflow role.

## URL Parameters

| Name                       | Type   |            | Description                       |
| -------------------------- | ------ | ---------- | --------------------------------- |
| **workflowRoleInstanceId** | string | `Required` | Id of the workflow role instance. |
| workflowItemId             | string | `Required` | Id of the workflow item           |

## JSON Parameters

| Name         | Type   |            | Description                      |
| ------------ | ------ | ---------- | -------------------------------- |
| **userId**   | string | `Required` | Id of the user to be added       |
| **userName** | string | `Required` | Username of the user to be added |

## Responses

| Status  | Name                       | Type   | Description                                                      |
| ------- | -------------------------- | ------ | ---------------------------------------------------------------- |
| **200** |                       |   | **Response contains a list of workflow teams just created.**     |
|    | workflowRoleInstanceUserId | string | Id of the newly created record in WorkflowRoleInstanceUser table |
|    | workflowItemId             | string | Id of the workflow item                                          |
|    | workflowRoleInstanceId     | string | Id of the WorkflowRoleInstance record                            |
|    | userId                     | string | Id of the user                                                   |
|    | memberId                   | string | MID the user belongs to                                          |
|    | enterpriseId               | string | EID the user’s MID belongs to                                    |
|    | modifiedBy                 | string | MemberId that created the record                                 |
|    |                       |   |                                                             |
| **400** |                       |   | **400 Bad Request**                                              |
|    | message                    | string | UserId is required.                                              |
|    | errorcode                  | string | Error code for the exception (10002)                             |
|    |                       |   |                                                             |
| **403** |                       |   | **403 Unauthorized**                                             |
|    | message                    | string | Insufficient Privileges.                                         |
|    | errorcode                  | string | Error code for the exception (20002)                             |
|    |                       |   |                                                             |
| **404** |                       |   | **404 Not Found**                                                |
|    | message                    | string | The UserId doesn’t exist, so the role user can’t be added.       |
|    | errorcode                  | string | Error code for the exception (30003)                             |