---
title: "Create a microfrontends group with applications"
method: POST
path: "/v1/microfrontends/group"
tags: ["microfrontends"]
---

# Create a microfrontends group with applications

`POST /v1/microfrontends/group`

Creates a microfrontends group and attaches multiple projects in a single request.

## Query parameters

- `teamId` string
- `slug` string

## Request body

- object
  - `groupName` string, required — The name of the microfrontends group that will be used to identify the group
  - `defaultApp` object, required — The default app for the new microfrontend group
    - `projectId` string, required — The id of the project that will be used as the default app for the new microfrontend group
    - `defaultRoute` string — The default route for the default app of the new microfrontend group
  - `otherApplications` object[], required — The list of other applications that will be used in the new microfrontend group
    - `projectId` string, required — The id of the project that will be used in the new microfrontend group
    - `defaultRoute` string — The default route for the application in the new microfrontend group

## Response `200`

- object
  - `newMicrofrontendsGroup` object, required
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `fallbackEnvironment` string, required
    - `enablePolyrepoBranchRouting` false | true, required
    - `createdAt` number, required
    - `updatedAt` number, required

## Other responses

- `400` — One of the provided values in the request body is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `410`
- `500`

## Changes

> 39 revisions in range; 26 could not be searched.

- **2026-07-21** `2ae10ee9d21c` — 1 info
  - added the non-success response with the status `410`

[Change history](https://skmtc.dev/vercel/apis/api/changes/v1/microfrontends/group/post.md)

---

[API](https://skmtc.dev/vercel/apis/api.md) · [All operations](https://skmtc.dev/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vercel/api/revisions/4191ba96b0c1/schema)