---
title: "POST /workflowstepgroups"
method: POST
path: "/workflowstepgroups"
---

# POST /workflowstepgroups

`POST /workflowstepgroups`

Create a step group in a migration workflow.

## Request body

- object
  - `workflowId` string, required — The ID of the migration workflow that will contain the step group.
  - `name` string, required — The name of the step group.
  - `description` string — The description of the step group.
  - `next` StringListMember[] — The next step group.
  - `previous` StringListMember[] — The previous step group.

## Response `200`

Success

- CreateWorkflowStepGroupResponse
  - `workflowId` string — The ID of the migration workflow that contains the step group.
  - `name` string — The name of the step group.
  - `id` string — The ID of the step group.
  - `description` string — The description of the step group.
  - `tools` Tool[] — List of AWS services utilized in a migration workflow.
    - `name` string — The name of an AWS service.
    - `url` string — The URL of an AWS service.
  - `next` StringListMember[] — The next step group.
  - `previous` StringListMember[] — The previous step group.
  - `creationTime` string, date-time — The time at which the step group is created.

## Other responses

- `480` — ThrottlingException
- `481` — AccessDeniedException
- `482` — InternalServerException
- `483` — ValidationException

---

[API](https://skmtc.net/aws/apis/migrationhuborchestrator.md) · [All operations](https://skmtc.net/aws/apis/migrationhuborchestrator/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/migrationhuborchestrator/versions/d388f030f5e3/schema)