# Create new team

Endpoint: POST /teams
Version: 2.0.0
Security: oauth2ClientCredentials

## Header parameters:

  - `org_wallet_ref` (string)
    Organization wallet reference, defaults to "1" if not provided

  - `business_id` (string, required)
    Business identifier for the request

## Request fields (application/json):

  - `name` (string, required)
    Team name

  - `email` (string)
    Team email

  - `phone` (string)
    Team phone

  - `code` (string)
    Team code

## Response 201 fields (application/json):

  - `_id` (string)
    Team MongoDB ID

  - `name` (string)
    Team name

  - `status` (string)
    Team status (ACTIVE/INACTIVE)

  - `email` (string)
    Team email

  - `phone` (string)
    Team phone

  - `reviewers` (array)
    Team reviewers

  - `reviewers.employee_id` (string)
    Employee ID

  - `reviewers.name` (string)
    Reviewer name

  - `reviewers.read_only` (boolean)
    Read-only access flag

  - `reviewers.added_by` (string)
    Added by user

  - `reviewers._id` (string)
    Reviewer MongoDB ID

  - `reviewers.added_on` (string)
    Date added

  - `code` (string)
    Team code

  - `createdAt` (string)
    Created timestamp

  - `__v` (number)
    Version key

  - `updatedAt` (string)
    Updated timestamp

  - `updated_by` (string)
    Updated by user ID

  - `alerts` (array)
    Alert configurations

  - `alerts.employee_id` (string)
    Employee ID

  - `alerts.phone` (string)
    Phone number

  - `alerts.name` (string)
    Name

  - `alerts.currency` (array)
    Currencies

  - `alerts._id` (string)
    Alert MongoDB ID

  - `budget` (array)
    Budget allocations

  - `budget.currency` (string)
    Currency code

  - `budget.amount` (number)
    Budget amount

  - `budget._id` (string)
    Budget MongoDB ID

  - `limit` (array)
    Spending limits

  - `limit.currency` (string)
    Currency code

  - `limit.amount` (number)
    Limit amount

  - `limit._id` (string)
    Limit MongoDB ID

  - `batching_enabled` (boolean)
    Batching enabled flag

  - `employee_count` (number)
    Number of employees in team

  - `total_balances` (array)
    Total balances by currency

  - `total_balances.currency` (string)
    Currency code

  - `total_balances.balance` (number)
    Current balance

  - `team_wallets` (array)
    Associated team wallets

  - `team_wallets.walletId` (string)
    Wallet ID

  - `team_wallets.accountNumber` (string)
    Account number

  - `team_wallets.availableBalance` (number)
    Available balance

  - `team_wallets.name` (string)
    Wallet name

  - `employees` (array)
    Employees in team

  - `employees._id` (string)
    Employee MongoDB ID

  - `employees.name` (string)
    Employee name

  - `employees.employee_id` (string)
    Employee ID

  - `employees.user` (string)
    User ID

  - `employees.wallets` (array)
    Employee wallets

  - `employees.wallets.boya_accno` (string)
    Boya account number

  - `employees.wallets.walletId` (string)
    Wallet ID

  - `employees.wallets.currency` (string)
    Currency code

  - `employees.wallets.availableBalance` (number)
    Available balance

  - `employees.wallets.wallet_type` (string)
    Wallet type

  - `employees.business` (string)
    Business ID

  - `employees.invited_on` (string)
    Invited on date

  - `employees.organization_email` (string)
    Organization email

  - `employees.phone` (string)
    Phone number

  - `employees.email_verified` (boolean)
    Email verified flag

  - `employees.status` (string)
    Employee status (ACTIVE/INACTIVE)

  - `employees.role` (string)
    Employee role

  - `employees.is_director` (boolean)
    Is director flag

  - `employees.consent_pending` (boolean)
    Consent pending flag

  - `employees.cards` (array)
    Associated cards

  - `employees.createdAt` (string)
    Created timestamp

  - `employees.updatedAt` (string)
    Updated timestamp

  - `employees.__v` (number)
    Version key

  - `employees.permissions` (object)
    Employee permissions

  - `employees.permissions.ALLOCATIONS_INITIATE` (number)
    Allocations initiate permission

  - `employees.permissions.ALLOCATIONS_VIEW` (number)
    Allocations view permission

  - `employees.permissions.BULK:PAYOUTS_INITIATE` (number)
    Bulk payouts initiate permission

  - `employees.permissions.BULK:PAYOUTS_VIEW` (number)
    Bulk payouts view permission

  - `employees.permissions.BUSINESS:STATEMENTS_VIEW` (number)
    Business statements view permission

  - `employees.permissions.BUSINESS:BALANCE_VIEW` (number)
    Business balance view permission

  - `employees.permissions.BUSINESS:BALANCE_EDIT` (number)
    Business balance edit permission

  - `employees.permissions.BUSINESS:TRENDS_VIEW` (number)
    Business trends view permission

  - `employees.permissions.BUSINESS:SETTINGS_VIEW` (number)
    Business settings view permission

  - `employees.permissions.BUSINESS:SETTINGS_EDIT` (number)
    Business settings edit permission

  - `employees.permissions.CARDS_VIEW` (number)
    Cards view permission

  - `employees.permissions.CARDS_EDIT` (number)
    Cards edit permission

  - `employees.permissions.EMPLOYEES:BALANCE_VIEW` (number)
    Employees balance view permission

  - `employees.permissions.PAYROLL_INITIATE` (number)
    Payroll initiate permission

  - `employees.permissions.PAYROLL_VIEW` (number)
    Payroll view permission

  - `employees.permissions.PAYABLES_INITIATE` (number)
    Payables initiate permission

  - `employees.permissions.PAYABLES_VIEW` (number)
    Payables view permission

  - `employees.permissions.PEOPLE_VIEW` (number)
    People view permission

  - `employees.permissions.PEOPLE_EDIT` (number)
    People edit permission

  - `employees.permissions.PEOPLE_ARCHIVE` (number)
    People archive permission

  - `employees.permissions.PEOPLE_ALLOCATE` (number)
    People allocate permission

  - `employees.permissions.EXPENSES_VIEW` (number)
    Expenses view permission

  - `employees.permissions.EXPENSES_EXPORT` (number)
    Expenses export permission

  - `employees.permissions.EXPENSES_REVIEW` (number)
    Expenses review permission

  - `employees.permissions.SETTINGS:CATEGORY_VIEW` (number)
    Settings category view permission

  - `employees.permissions.SETTINGS:CATEGORY_EDIT` (number)
    Settings category edit permission

  - `employees.permissions.SETTINGS:INTEGRATIONS_VIEW` (number)
    Settings integrations view permission

  - `employees.permissions.SETTINGS:INTEGRATIONS_EDIT` (number)
    Settings integrations edit permission

  - `employees.permissions.SETTINGS:ROLES_VIEW` (number)
    Settings roles view permission

  - `employees.permissions.SETTINGS:REPRESENTATIVES_VIEW` (number)
    Settings representatives view permission

  - `employees.permissions.SETTINGS:REPRESENTATIVES_EDIT` (number)
    Settings representatives edit permission

  - `employees.permissions.INVOICE_VIEW` (number)
    Invoice view permission

  - `employees.permissions.INVOICE_EDIT` (number)
    Invoice edit permission

  - `employees.permissions.SUPPLIER_VIEW` (number)
    Supplier view permission

  - `employees.permissions.SUPPLIER_EDIT` (number)
    Supplier edit permission

  - `employees.permissions.SUB:ACCOUNTS_VIEW` (number)
    Sub-accounts view permission

  - `employees.permissions.SUB:ACCOUNTS_EDIT` (number)
    Sub-accounts edit permission

  - `employees.permissions.SUB:ACCOUNTS_ALLOCATE` (number)
    Sub-accounts allocate permission

  - `employees.permissions.BUDGETS_CREATE` (number)
    Budgets create permission

  - `employees.permissions.SUBSCRIPTIONS_VIEW` (number)
    Subscriptions view permission

  - `employees.permissions.EXPENSES:RECEIPT_EDIT` (number)
    Expenses receipt edit permission

  - `employees.last_login_at` (string)
    Last login timestamp

  - `employees.team` (object)
    Employee team

  - `employees.team.code` (string)
    Team code

  - `employees.team.name` (string)
    Team name

  - `employees.team._id` (string)
    Team MongoDB ID

  - `employees.team.status` (string)
    Team status

  - `employees.notification_preferences` (array)
    Notification preferences

  - `employees.tags` (array)
    Employee tags

  - `employees.supervisor` (string)
    Supervisor ID

  - `employees.external_id` (string)
    External ID

  - `employees.id` (string)
    Auto-generated ID

  - `id` (string)
    Auto-generated ID