> ## Documentation Index > Fetch the complete documentation index at: https://developer.zeeg.me/llms.txt > Use this file to discover all available pages before exploring further. # Create a Team > Create a team in your workspace with its title, slug and time zone. You become the team's manager. ## OpenAPI ````yaml POST /teams openapi: 3.0.0 info: title: Zeeg Public API description: >- Zeeg public API documentation. ## Authentication All endpoints require a Bearer token. You can generate an API token from [your Zeeg dashboard](https://app.zeeg.me/account/settings/api-access). Each token is scoped to specific permissions (e.g. `events:read`, `webhooks:write`). Make sure your token has the required scopes for the endpoints you want to use. ## Responses Every response is JSON, whatever `Accept` header the request sends. version: 2.0.0 x-logo: url: https://app.zeeg.me/img/logo-dark.2ca83593.svg backgroundColor: '#f7f7f9' altText: zeeg contact: name: Zeeg Support email: support@zeeg.me url: https://zeeg.me/en/contact license: name: Proprietary url: https://zeeg.me/en/legal/terms termsOfService: https://zeeg.me/en/legal/terms servers: - url: https://api.zeeg.me/v2 description: Production security: - bearer: [] tags: - name: Scheduled Events description: Management of events scheduled via Zeeg - name: Scheduling Pages description: Scheduling pages information and management - name: Availability Schedule description: Read and change availability for users - name: Webhooks description: Webhooks management - name: Notes description: Notes for scheduled events - name: Workspaces & Teams description: Workspace users and team member management - name: AI Agent description: AI Agent integration endpoints - name: Payloads description: Webhook payload schemas - name: CRM - Objects description: >- Discover the schema of CRM objects (standard and custom) including all attribute definitions - name: CRM - Companies description: Create, read, update, and delete CRM company records - name: CRM - People description: Create, read, update, and delete CRM person records - name: Routing Forms - Forms description: Read routing forms with their questions and their routes - name: Routing Forms - Submissions description: Read and delete the submissions that invitees send through a routing form paths: /teams: post: tags: - Workspaces & Teams summary: Create a team description: >- Creates a team in your workspace. You become its manager; a partner creates the team for the workspace owner, who becomes its manager. The workspace owner, admins and partners can create teams, as many as the plan allows. **Required scope:** `teams:write` operationId: post-teams requestBody: required: true content: application/json: schema: allOf: - $ref: '#/components/schemas/TeamWrite' - required: - title - slug - timezone examples: Create a team: value: title: Customer Success slug: customer-success timezone: Europe/Berlin welcomeMessage: Book a call with our customer success team. responses: '201': description: Created content: application/json: schema: type: object properties: success: type: boolean example: true status: type: integer example: 201 team: $ref: '#/components/schemas/Team' '401': $ref: '#/components/responses/401' '403': description: The token misses the scope, or your role may not create teams. content: application/json: schema: $ref: '#/components/schemas/WorkspaceError' examples: Not allowed: value: success: false message: Only the workspace owner and admins can create teams. status: 403 '422': description: >- A field is invalid (flat Laravel shape with `errors`), or the plan allows no more teams (`message` only). content: application/json: schema: oneOf: - $ref: '#/components/schemas/WorkspaceError' - type: object properties: message: type: string errors: type: object additionalProperties: type: array items: type: string examples: Slug taken: value: message: The slug has already been taken. errors: slug: - The slug has already been taken. Team limit reached: value: success: false message: >- You have the maximum number of teams in the current plan. Please get in touch with us to increase the limit. status: 422 security: - bearer: [] components: schemas: TeamWrite: type: object properties: title: type: string maxLength: 200 example: Customer Success slug: type: string description: >- The address of the team's public page. Turned into a URL-safe form (lowercase, hyphens) and unique across every team and user. example: customer-success timezone: type: string description: IANA time zone. example: Europe/Berlin country: type: string description: >- ISO 3166-1 alpha-2 country code. On create it defaults to the country of `timezone`; a zone with no country, such as UTC, needs it. example: DE welcomeMessage: type: string nullable: true maxLength: 300 description: Shown on the team's public page. HTML is removed. Team: type: object description: >- A team of the workspace with its member and manager counts. `GET /teams/{teamId}/members` lists the members. properties: id: type: string format: uuid example: 73e4761b-5257-4e83-a807-974a3f2f3adc title: type: string example: Customer Success slug: type: string description: >- The team's public page lives at `link`. Changing the slug changes that address, and links shared before stop working. example: customer-success link: type: string format: uri example: https://zeeg.me/customer-success country: type: string description: ISO 3166-1 alpha-2 country code. example: DE timezone: type: string example: Europe/Berlin welcomeMessage: type: string nullable: true example: Book a call with our customer success team. memberCount: type: integer description: >- Active members, managers included. `GET /teams/{teamId}/members` lists them. example: 5 managerCount: type: integer description: Active members with the role `manager`. example: 1 createdAt: type: string format: date-time updatedAt: type: string format: date-time WorkspaceError: type: object description: The error envelope of the team and invitation endpoints. properties: success: type: boolean example: false message: type: string status: type: integer responses: '401': description: Unauthorized content: application/json: schema: type: object properties: message: type: string example: Unauthenticated. examples: Unauthenticated: value: message: Unauthenticated. securitySchemes: bearer: type: http scheme: bearer description: '' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.