Skip to content
/Authentication

ContextSMS Webex Bot API (1.0.0)

Overview

Build powerful customer-facing Webex integrations with enterprise messaging capabilities.

Key Features

  • Enterprise Authentication - Secure Bearer token authentication
  • Enterprise Management - Create and manage customer organizations
  • Phone Number Mapping - Link phone numbers to Webex identities
  • Real-time Webhooks - Instant message event notifications
  • Multi-environment - Separate development and production environments

Quick Integration Flow

  1. Authenticate → Get your Bearer token via login
  2. Create Enterprise → Set up customer organization with CSP ID
  3. Add Mapping → Link phone number to Webex identity
  4. Handle Events → Process incoming webhook notifications

Base URLs

  • Production: https://webex-backend.sabrhub.com/v1
  • Authentication: https://usermanagement.sabrhub.com/v1

Note: Parameters marked with * are required.

Download OpenAPI description
contextsms-webex.external.json
contextsms-webex.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-webex.external
Production Environment (live)
https://context-webex.sabrhub.com/api/v1
Authentication Server (production)
https://usermanagement.sabrhub.com/v1

Authentication

Endpoints for user login and token management to securely access the API.

Operations

Authenticate user and return access and refresh tokens

Request

Authenticate user with credentials and return an accessToken (JWT), refreshToken, and user info on success.

Security
BearerAuth
Bodyapplication/jsonrequired
usernamestringrequired
Example: "test@email.com"
passwordstringrequired
Example: "Ni*nsl$k3n("
curl -X POST "https://usermanagement.sabrhub.com/v1/auth/login" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "username": "test@email.com",
    "password": "Ni*nsl$k3n("
  }'

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
tenantIdstring
Example: "tenant123"
servicesArray of strings
Response
application/json
{
  "username": "test@email.com",
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expirationTimeInUTC": "2024-02-29T15:09:14.242875589",
  "roles": [
    "string"
  ],
  "tenantId": "tenant123",
  "services": [
    "string"
  ]
}

Exchange refresh token and return a new access token

Request

Use the provided refreshToken to obtain a new accessToken. Returns accessToken, refreshToken and expiration details.

Security
BearerAuth
Bodyapplication/jsonrequired
usernamestringrequired
Example: "test@email.com"
refreshTokenstringrequired
Example: "<REFRESH_TOKEN>"
curl -X POST "https://usermanagement.sabrhub.com/v1/auth/getaccesstoken" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "username": "test@email.com",
    "refreshToken": "<REFRESH_TOKEN>"
  }'

Responses

Access token refreshed successfully

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
tenantIdstring
Example: "tenant123"
servicesArray of strings
Response
application/json
{
  "username": "test@email.com",
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expirationTimeInUTC": "2024-02-29T15:09:14.242875589",
  "roles": [
    "string"
  ],
  "tenantId": "tenant123",
  "services": [
    "string"
  ]
}

Enterprise Management

APIs for creating, retrieving, and deleting enterprises.

Operations

Mapping Management

APIs for creating, retrieving and deleting number-to-message-app mappings.

Operations

CSP-User-Management

Operations for creating, removing, and managing CSP users in ContextSMS.

Operations