Create a team

POST

/teams

Creates a Postman team in your organization.

[Creates](https://learning.postman.com/docs/administration/managing-your-team/create-teams/) a Postman team in your organization.

Authentication

x-api-keystring

API Key authentication via header

Authorizationstring

A valid SCIM API key for calls to SCIM endpoints.

A valid [SCIM API key](https://learning.postman.com/docs/administration/scim-provisioning/scim-provisioning-overview/#generating-scim-api-key) for calls to SCIM endpoints.

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

Request

This endpoint expects an object.

namestringOptional

The team's name. Accepts only alphanumeric characters and spaces.

descriptionstring or nullOptional

The team's description.

Response

Successful Response

teamobject

Information about the team.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

$	curl -X POST https://api.getpostman.com/teams \
>	-H "x-api-key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Testing Team",
>	"description": "API testing team."
>	}'

1	{
2	"team": {
3	"createdAt": "2025-02-26T08:17:42.000Z",
4	"updatedAt": "2025-02-26T08:17:42.000Z",
5	"id": 123,
6	"name": "Testing Team",
7	"handle": "testing-team",
8	"description": "API testing team.",
9	"organizationId": 1,
10	"createdBy": 12345678,
11	"enabled": true
12	}
13	}

Authentication

Headers

Request

Response

Errors