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

---

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