Skip to content
Core APIs
/
/
Read Single Enterprise

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

Enterprise Management

APIs for creating, retrieving, and deleting enterprises.

Operations

Create a new enterprise for a given CSP and return details

Request

Create a new enterprise record under the specified CSP. Returns the created enterprise object.

Security
BearerAuth
Path
cspIdstringrequired

CSP identifier (e.g. CSP001)

Example: CSP001
Bodyapplication/jsonrequired
namestringrequired

Name of the enterprise

Example: "test enterprise2"
contactstringrequired

Enterprise contact name

Example: "Test Contact"
numberstringrequired

Enterprise contact number

Example: "+12223334444"
emailstringrequired

Enterprise business admin email

Example: "test@email.com"
defaultMmsSelectionboolean

Default selection of the mmsEnabled flag when creating NumberMapping. If MMS feature is Strict or Disabled, follow the feature settings. If Partial, can be true or false.

Example: true
curl -i -X POST \
  https://context-docs.sabrhub.com/_mock/specs/contextsms-webex.external/enterprise/CSP001 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "test enterprise2",
    "contact": "Test Contact",
    "number": "+12223334444",
    "email": "test@email.com",
    "defaultMmsSelection": true
  }'

Responses

Enterprise created successfully.

Bodyapplication/json
enterpriseIdstring
Example: "E0000090"
namestring
Example: "test enterprise2"
contactstring
Example: "Test Contact"
numberstring
Example: "+12223334444"
emailstring
Example: "test@email.com"
deletedboolean
Example: false
createdDateinteger
Example: 1698446777442
updateDateinteger
Example: 1698446777443
webexSettingsobject or null
numberToMessageAppMapsArray of arrays or null or null
defaultMmsSelectionboolean
Example: true
Response
application/json
{
  "enterpriseId": "E0000090",
  "name": "test enterprise2",
  "contact": "Test Contact",
  "number": "+12223334444",
  "email": "test@email.com",
  "deleted": false,
  "createdDate": 1698446777442,
  "updateDate": 1698446777443,
  "webexSettings": {},
  "numberToMessageAppMaps": [],
  "defaultMmsSelection": true
}

Read Single Enterprise

Request

Retrieve enterprise details by enterpriseId. Returns enterprise object or 404.

Security
BearerAuth
Path
enterpriseIdstringrequired

Enterprise identifier

Example: E0000090
curl -X GET "https://webex-dev-frontend.sabrhub.com/api/v1/enterprise/getenterprise/{enterpriseId}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Responses

Enterprise found successfully.

Bodyapplication/json
enterpriseIdstring
Example: "E0000090"
namestring
Example: "test enterprise2"
contactstring
Example: "Test Contact"
numberstring
Example: "+12223334444"
emailstring
Example: "test@email.com"
deletedboolean
Example: false
createdDateinteger
Example: 1698446777442
updateDateinteger
Example: 1698446777443
webexSettingsobject or null
numberToMessageAppMapsArray of arrays or null or null
defaultMmsSelectionboolean
Example: true
Response
application/json
{
  "enterpriseId": "E0000090",
  "name": "test enterprise2",
  "contact": "Test Contact",
  "number": "+12223334444",
  "email": "test@email.com",
  "deleted": false,
  "createdDate": 1698446777442,
  "updateDate": 1698446777443,
  "webexSettings": {},
  "numberToMessageAppMaps": [],
  "defaultMmsSelection": true
}

List enterprises for a specified CSP (supports pagination).

Request

List enterprises for a specified CSP with pagination support

Security
BearerAuth
Path
cspIdstringrequired

CSP identifier (e.g. CSP001)

Example: CSP001
curl -X GET "https://context-webex.sabrhub.com/api/v1/csp/enterprises/{cspId}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Responses

Enterprises retrieved successfully.

Bodyapplication/jsonArray [
enterpriseIdstring
Example: "E0000090"
namestring
Example: "test enterprise2"
contactstring
Example: "Test Contact"
numberstring
Example: "+12223334444"
emailstring
Example: "test@email.com"
deletedboolean
Example: false
createdDateinteger
Example: 1698446777442
updateDateinteger
Example: 1698446777443
webexSettingsobject or null
numberToMessageAppMapsArray of arrays or null or null
defaultMmsSelectionboolean
Example: true
]
Response
application/json
[
  {
    "enterpriseId": "E0000090",
    "name": "test enterprise2",
    "contact": "Test Contact",
    "number": "+12223334444",
    "email": "test@email.com",
    "deleted": false,
    "createdDate": 1698446777442,
    "updateDate": 1698446777443,
    "webexSettings": {},
    "numberToMessageAppMaps": [],
    "defaultMmsSelection": true
  }
]

Delete an enterprise by ID and return operation result

Request

Delete the enterprise identified by enterpriseId. Returns 204 on success or 404 if not found.

Security
BearerAuth
Path
enterpriseIdstringrequired

Enterprise identifier

Example: E0000090
curl -X DELETE "https://webex-dev-frontend.sabrhub.com/api/v1/enterprise/deleteenterprise/{enterpriseId}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Responses

Enterprise deleted successfully.

Bodyapplication/json
messagestring
Example: "Enterprise deleted successfully"
Response
application/json
{
  "message": "Enterprise deleted successfully"
}

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