---
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`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/microfrontends/group`
- Auth: HTTP bearer

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
    - `createdAt` number, required
    - `enablePolyrepoBranchRouting` false | true, required
    - `fallbackEnvironment` string, required
    - `id` string, required
    - `name` string, required
    - `slug` string, 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.
- `404`
- `410`
- `500`

## Changes

- **2026-09-30** `099fbe1f521c`: 1 info
  - added the non-success response with the status `404`
- **2026-08-20** `b4b4b597ab64`: 1 info
  - added the required property `newMicrofrontendsGroup/enablePolyrepoBranchRouting` to the response with the `200` status
- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2026-06-11** `14b4658f819e`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/vercel/apis/vercel-api.md) - [All operations](https://skmtc.dev/vercel/apis/vercel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/vercel-api/revisions/60686c0e1f6a?raw)