---
title: "Create plan-only team"
method: POST
path: "/rest/api/3/plans/plan/{planId}/team/planonly"
tags: ["Teams in plan"]
---

# Create plan-only team

`POST /rest/api/3/plans/plan/{planId}/team/planonly`

## Request

- Base URL: `https://your-domain.atlassian.net`
- URL: `https://your-domain.atlassian.net/rest/api/3/plans/plan/{planId}/team/planonly`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `https://auth.atlassian.com/authorize`
    - Token URL: `https://auth.atlassian.com/oauth/token` scopes: `write:jira-work`

Creates a plan-only team and configures their planning settings.

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

## Path parameters

- `planId` integer, required

## Request body

- CreatePlanOnlyTeamRequest
  - `capacity` number, double: The capacity for the plan-only team.
  - `issueSourceId` integer: The ID of the issue source for the plan-only team.
  - `memberAccountIds` string[]: The account IDs of the plan-only team members.
  - `name` string, required: The plan-only team name.
  - `planningStyle` 'Scrum' | 'Kanban', required: The planning style for the plan-only team. This must be "Scrum" or "Kanban".
  - `sprintLength` integer: The sprint length for the plan-only team.

## Response `201`

Returned if the request is successful.

- integer

## Other responses

- `400`: Returned if the request is not valid.
- `401`: Returned if the user is not logged in.
- `403`: Returned if the site has no premium edition of Jira or if the user does not have the Administer Jira global permission.
- `404`: Returned if the plan is not found.
- `409`: Returned if the plan is not active.

## Changes

- **2025-02-20** `25c5ce462677`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3/changes/rest/api/3/plans/plan/:planId/team/planonly/post.md)

---

[API](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3.md) - [All operations](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3/revisions/f22db3da5feb?raw)