Skip to content
/Authentication

ContextSMS Teams Platform API (1.0.0)

Overview

Build unified Microsoft Teams integrations with enterprise messaging capabilities.

Platform Capabilities

  • Unified Teams Integration - Connect Teams with external messaging systems
  • Multi-tenant Support - Manage multiple customer organizations efficiently
  • Advanced Routing - Intelligent message routing and delivery
  • Real-time Messaging - Instant message delivery and notifications

Integration Workflow

  1. Authenticate → Secure login with Bearer token
  2. Configure Team → Set up organization settings
  3. Manage Channels → Create and configure team channels
  4. Route Messages → Handle message routing and delivery
  5. Process Webhooks → Real-time event notifications
Download OpenAPI description
contextsms-teams.external.json
contextsms-teams.external.yaml
Overview
URL
https://sabrhub.com/support
Sabrhub API Support Team
support@sabrhub.com
License
MIT
Terms of Service
Languages
Servers
Mock server
https://context-docs.sabrhub.com/_mock/specs/contextsms-teams.external
Teams Backend Server (production)
https://teams-backend.sabrhub.com
Authentication Server (production)
https://usermanagement.sabrhub.com/v1

Authentication

Endpoints related to user authentication and token management

Operations

Authenticate Teams user and issue tokens

Request

Authenticate Teams user with username and password to obtain access tokens. This endpoint is specifically for Teams authentication and does not support service fallback.

Security
BearerAuth
Bodyapplication/jsonrequired
usernamestring(email)required

User email address

passwordstringrequired

User password

curl -X POST "https://usermanagement.sabrhub.com/v1/teams-auth/login" \
  -H "Content-Type: application/json" \
  -d '{"username": "test@email.com", "password": "securePassword123"}'

Responses

Login successful

Bodyapplication/json
usernamestring
Example: "test@email.com"
accessTokenstring
Example: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
refreshTokenstring
Example: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
expirationTimeInUTCstring(date-time)
Example: "2024-02-29T15:09:14.242875589"
rolesArray of strings
Example: ["CSP_BUSINESS"]
tenantIdstring
Example: "Sabrhub"
servicesArray of strings
Example: ["Teams"]
Response
application/json
{
  "username": "test@email.com",
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expirationTimeInUTC": "2024-02-29T15:09:14.242875589",
  "roles": [
    "CSP_BUSINESS"
  ],
  "tenantId": "Sabrhub",
  "services": [
    "Teams"
  ]
}

Create a new Teams user

Request

Creates a new user in the Teams user pool. Requires authentication and proper role permissions. The user must have permission to create users with the specified roles.

Security
BearerAuth
Bodyapplication/jsonrequired
emailstring(email)required

User email address

Example: "newuser@example.com"
passwordstringrequired

User password

Example: "SecurePassword123!"
rolesArray of stringsrequired

Array of user roles (must have at least one role)

Example: ["MAPPED_USER"]
servicesArray of strings

Array of services the user has access to (optional, defaults to Teams)

Example: ["Teams"]
tenantIdstring

Tenant ID for the user (optional, auto-assigned if not provided)

Example: "Sabrhub"
enterpriseIdstring

Enterprise ID associated with the user (optional)

Example: "E0000001"
toMigrateboolean

Flag indicating if user should be migrated (default: false)

Default false
Example: false
notifyUserboolean

Whether to notify the user via email (default: true)

Default true
Example: true
curl -X POST "https://usermanagement.sabrhub.com/v1/teams-auth/createuser" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "newuser@example.com",
    "password": "SecurePassword123!",
    "roles": ["MAPPED_USER"],
    "services": ["Teams"],
    "notifyUser": true
  }'

Responses

User created successfully

Bodytext/plain
string

Enterprise Management

APIs for creating, retrieving, listing, and deleting enterprises

Operations

Mapping Management

Manage phone number-to-messaging app mappings across enterprises

Operations