---
title: "Create a team"
method: POST
path: "/teams"
tags: ["Teams"]
---

# Create a team

`POST /teams`

## Request

- Base URL: `https://api.presscart.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.presscart.com/teams`
- Auth: HTTP bearer

Create an  team.

## Request body

- object
  - `name` string, required
  - `team_type_id` string, uuid, nullable, required

## Response `201`

Team created successfully

- object
  - `id` string, uuid, required
  - `name` string, required
  - `slug` string, required
  - `referral_code` string, nullable, required
  - `stripe_customer_id` string, nullable, required
  - `team_type_id` string, uuid, nullable, required
  - `hubspot_company_id` string, nullable, required
  - `pro_pricing_enabled` boolean, required
  - `has_completed_onboarding` boolean, required
  - `can_access_paid_media_list` boolean, required
  - `is_publisher` boolean, required
  - `daily_order_dispatch_enabled` boolean, required
  - `agreement_signed_at` union, required
    - string, nullable
    - string
    - unknown
  - `agreement_document` string, nullable, required
  - `applied_at` union, required
    - string, nullable
    - string
    - unknown
  - `website_url` string, uri, nullable, required
  - `publisher_pending_outlet_cap` integer, nullable, required
  - `outlet_ownership_proof_exempt` boolean, required
  - `publisher_prompt_dismissed_at` union, required
    - string, nullable
    - string
    - unknown
  - `blocked_at` union, required
    - string, nullable
    - string
    - unknown
  - `blocked_until` union, required
    - string, nullable
    - string
    - unknown
  - `contact_email` string, email, nullable, required
  - `billing_email` string, email, nullable, required
  - `created_at` union, required
    - string, nullable
    - string
    - unknown
  - `updated_at` union, required
    - string, nullable
    - string
    - unknown
  - `deleted_at` union, required
    - string, nullable
    - string
    - unknown
  - `membership` union, required
    - TeamMember
      - `id` string, uuid, required
      - `user_id` string, uuid, required
      - `team_id` string, uuid, required
      - `role` 'OWNER' | 'ADMIN' | 'MEMBER', required
      - `created_at` union, required
        - string, nullable
        - string
        - unknown
      - `updated_at` union, required
        - string, nullable
        - string
        - unknown
      - `deleted_at` union, required
        - string, nullable
        - string
        - unknown
      - `first_name` string
      - `last_name` string
      - `email` string, email
    - unknown
    - unknown
  - `profile_id` string, uuid, required

---

[API](https://skmtc.dev/presscart/apis/presscart-prod-api.md) · [All operations](https://skmtc.dev/presscart/apis/presscart-prod-api/llms.txt) · [OpenAPI document](https://skmtc.dev/presscart/apis/presscart-prod-api/revisions/2154581d845e?raw)