API v2/POST

Create a teams login

POST
/v2/teams-logins

Authorization

ApiKeyAuth
x-meeting-baas-api-key<token>

Your Meeting BaaS API key. Get one from your account settings.

In: header

Request Body

application/json

email*string

Email of the Microsoft 365 account this login signs in as.

Match^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
Formatemail
Lengthlength <= 254
email_group?string

Optional address used for round-robin pooling. Logins sharing the same email_group form one round-robin pool.

Match^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
Formatemail
Lengthlength <= 254
extra?|
name*string

User-friendly label for this credential. Not unique — names can repeat within a team.

Length1 <= length <= 100
password*string

Password for the Microsoft 365 account. Write-only — encrypted at rest (AES-256-GCM) and never returned in any response.

Length1 <= length <= 1024
workspace_id*string

UUID of the parent teams_workspace. Create one via POST /v2/teams-workspaces first.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.meetingbaas.com/v2/teams-logins" \  -H "Content-Type: application/json" \  -d '{    "email": "bot1@bots.customer.onmicrosoft.com",    "name": "Teams Bot Pool — Account 1",    "password": "••••••••",    "workspace_id": "f0e1d2c3-b4a5-6789-0123-456789abcdef"  }'
{
  "data": {
    "active_session_count": 9007199254740991,
    "created_at": "string",
    "credential_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "email": "string",
    "email_group": "string",
    "extra": {
      "environment": "production",
      "internal_user_id": "u_123"
    },
    "failure_data": null,
    "last_error_at": "string",
    "last_error_message": "string",
    "last_used_at": "string",
    "name": "string",
    "state": "active",
    "updated_at": "string",
    "workspace_id": "string"
  },
  "success": true
}
{
  "code": "string",
  "error": "string",
  "message": "string",
  "statusCode": 9007199254740991,
  "success": false
}
{
  "code": "string",
  "details": "string",
  "error": "string",
  "message": "string",
  "statusCode": 9007199254740991,
  "success": false
}
{
  "code": "string",
  "details": "string",
  "error": "string",
  "message": "string",
  "retryAfter": 9007199254740991,
  "statusCode": 9007199254740991,
  "success": false
}
{
  "code": "string",
  "details": "string",
  "error": "string",
  "message": "string",
  "statusCode": 9007199254740991,
  "success": false
}