---
title: Create a workflow
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/post-v1-ciworkflows
---

# Create a workflow

Create a new Xcode Cloud workflow for an Xcode Cloud product.

## URL

POST https://api.appstoreconnect.apple.com/v1/ciWorkflows

## Response Codes

201 Created: The request completed successfully and a new Workflows resource has been created. 400 Bad Request: An error occurred with your request. 401 Unauthorized: 403 Forbidden: Request not authorized. 409 Conflict: The provided resource data is not valid. 422 : 429 :

## Discussion

Discussion The example request below creates a new workflow that performs the archive action. App Store Connect returns the 201 HTTP status code to indicate the successful creation of the workflow and returns information about the workflow. Use the data to access additional information or to start a new build. Example Request and Response

## HTTP Body

The request body you use to create a new Xcode Cloud workflow.

## See Also

### Managing Xcode Cloud Workflows

- [Update an xcode cloud workflow](appstoreconnectapi/patch-v1-ciworkflows-_id_.md)
- [Delete a workflow](appstoreconnectapi/delete-v1-ciworkflows-_id_.md)