---
title: "POST /api/v1.0/{appId}/teammates"
method: POST
path: "/api/v1.0/{appId}/teammates"
tags: ["Teammates"]
---

# POST /api/v1.0/{appId}/teammates

`POST /api/v1.0/{appId}/teammates`

## Path parameters

- `appId` string, required

## Request body

- CreateTeammate
  - `Email` string — Email address
  - `AppAccessLevel` 'None' | 'Owner' | 'StoreOwner' | 'PropertyOwner' | 'ManagedOwner' | 'Integrator' | 'PropertyManager' | 'StoreManager' | 'StoreStaff' | 'StaffMember' | 'StoreReadOnlyAccess' | 'FinanceManger' | 'Onboarding' | 'Support' — App access level
  - `HasAccessToAllStores` boolean — The user has access to all stores for the app (including new stores that added later)
  - `StoreIds` integer[] — Store IDs the user has access to (if HasAccessToAllStores is false)
  - `PropertyIds` string[] — Property Ids the user has access to (if HasAccessToAllStores is false)

## Response `200`

OK

- RestApiResultTeammate — Rest api result
  - `Data` Teammate, required
    - `TeammateId` string — Unique indentifier
    - `UserId` integer, nullable — User ID of the teammate
    - `Name` string — Name
    - `LastActivity` string, date-time, nullable — Last activity
    - `AppId` string — Access level is for this App
    - `InvitationStatus` 'Pending' | 'Accepted' | 'Expired' — Invitation status
    - `Email` string — Email address
    - `AppAccessLevel` 'None' | 'Owner' | 'StoreOwner' | 'PropertyOwner' | 'ManagedOwner' | 'Integrator' | 'PropertyManager' | 'StoreManager' | 'StoreStaff' | 'StaffMember' | 'StoreReadOnlyAccess' | 'FinanceManger' | 'Onboarding' | 'Support' — App access level
    - `HasAccessToAllStores` boolean — The user has access to all stores for the app (including new stores that added later)
    - `StoreIds` integer[] — Store IDs the user has access to (if HasAccessToAllStores is false)
    - `PropertyIds` string[] — Property Ids the user has access to (if HasAccessToAllStores is false)

## Other responses

- `400` — BadRequest
- `401` — Authentication has been denied for this request.
- `403` — Successful authentication, but authorization has been denied for this request.
- `404` — NotFound

---

[API](https://skmtc.net/flipdish/apis/flipdish-open-api-v1-0.md) · [All operations](https://skmtc.net/flipdish/apis/flipdish-open-api-v1-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flipdish/flipdish-open-api-v1-0/versions/a72c0465da74/schema)