Create a team | Documentation

curl -X POST https://api.contentful.com/organizations/4EJGvuLTBUMG2A6wS8gfAS/teams \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Project Editors",
  "description": ""
}'

{
  "name": "Project Editors",
  "description": "",
  "sys": {
    "id": "7BslKh9TdKGOK41VmLDjFZ",
    "type": "Team",
    "organization": {
      "sys": {
        "type": "Link",
        "linkType": "Organization",
        "id": "4EJGvuLTBUMG2A6wS8gfAS"
      }
    },
    "createdAt": "2025-09-14T11:22:29.000Z",
    "updatedAt": "2025-09-14T11:22:29.000Z",
    "updatedBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "7BslKh9TdKGOK41VmLDjFZ"
      }
    },
    "createdBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "7BslKh9TdKGOK41VmLDjFZ"
      }
    },
    "memberCount": 0
  }
}

Creates a new team in the organization. Only organization admins and owners can create teams.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

organization_idstringRequired

The organization ID

Request

This endpoint expects a map from strings to any.

Response

Created - Team created successfully