# Create new employee

Endpoint: POST /employees
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)
    Employee name

  - `organization_email` (string, required)
    Organization email

  - `personal_email` (string)
    Personal email

  - `phone` (string)
    Phone number

  - `status` (object)
    Employee status

  - `role` (object)
    Employee role

  - `is_director` (boolean)
    Is director

  - `team_code` (string)
    Team Code

  - `supervisor` (string)
    Supervisor ID

  - `external_id` (string)
    External ID

  - `tags` (array)
    Employee tags

  - `invited_on` (string)
    Invited on date

  - `access_expiry_date` (object)
    Employee access expiry date

## Response 201 fields (application/json):

  - `_id` (string)
    Employee MongoDB ID

  - `name` (string)
    Employee name

  - `employee_id` (string)
    Employee ID

  - `user` (string)
    User ID

  - `wallets` (array)
    Employee wallets

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

  - `wallets.walletId` (string)
    Wallet ID

  - `wallets.currency` (string)
    Currency code

  - `wallets.availableBalance` (number)
    Available balance

  - `wallets.wallet_type` (string)
    Wallet type

  - `business` (string)
    Business ID

  - `invited_on` (string)
    Invited on date

  - `organization_email` (string)
    Organization email

  - `phone` (string)
    Phone number

  - `email_verified` (boolean)
    Email verified flag

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

  - `role` (string)
    Employee role

  - `is_director` (boolean)
    Is director flag

  - `consent_pending` (boolean)
    Consent pending flag

  - `cards` (array)
    Associated cards

  - `createdAt` (string)
    Created timestamp

  - `updatedAt` (string)
    Updated timestamp

  - `__v` (number)
    Version key

  - `permissions` (object)
    Employee permissions

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  - `last_login_at` (string)
    Last login timestamp

  - `team` (object)
    Employee team

  - `team.code` (string)
    Team code

  - `team.name` (string)
    Team name

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

  - `team.status` (string)
    Team status

  - `notification_preferences` (array)
    Notification preferences

  - `tags` (array)
    Employee tags

  - `supervisor` (string)
    Supervisor ID

  - `external_id` (string)
    External ID

  - `id` (string)
    Auto-generated ID