Skip to content

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
Overview
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

Enterprise Management

APIs for creating, retrieving, listing, and deleting enterprises

Operations

Request

Create a new enterprise. Returns enterprise metadata, created/update timestamps and status.

Security
BearerAuth
Path
cspIdstringrequired

Unique ID for which the enterprise is being created.

Example: CSP0000003
Bodyapplication/jsonrequired
namestringrequired
Example: "test"
contactstringrequired
Example: "test"
numberstringrequired
Example: "+13234222322"
emailstring(email)required
Example: "test@gmail.com"
defaultMmsSelectionboolean

Default MMS selection preference

Example: true
enterpriseFeaturesArray of objects

Array of platform-specific enterprise feature configurations

Example: [{"platformType":"Teams","enabled":true,"groupTexting":true,"broadcastTexting":true,"mmsEnabled":false,"teamTexting":true,"scheduleSend":true,"aiSmartReplies":false,"aiChatAssist":false,"cdrAccess":false,"crmIntegration":false,"contactsIntegration":false},{"platformType":"Webex","enabled":true,"groupTexting":true,"broadcastTexting":true,"mmsEnabled":false,"teamTexting":true,"scheduleSend":true,"aiSmartReplies":false,"aiChatAssist":false,"cdrAccess":false,"crmIntegration":false,"contactsIntegration":false}]
curl -X POST "https://teams-backend.sabrhub.com/enterprise/CSP0000003" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "test",
    "contact": "test",
    "number": "+13234222322",
    "email": "test@gmail.com",
    "defaultMmsSelection": true,
    "enterpriseFeatures": [
      {
        "platformType": "Teams",
        "enabled": true,
        "groupTexting": true,
        "broadcastTexting": true,
        "mmsEnabled": false,
        "teamTexting": true,
        "scheduleSend": true,
        "aiSmartReplies": false,
        "aiChatAssist": false,
        "cdrAccess": false,
        "crmIntegration": false,
        "contactsIntegration": false
      },
      {
        "platformType": "Webex",
        "enabled": true,
        "groupTexting": true,
        "broadcastTexting": true,
        "mmsEnabled": false,
        "teamTexting": true,
        "scheduleSend": true,
        "aiSmartReplies": false,
        "aiChatAssist": false,
        "cdrAccess": false,
        "crmIntegration": false,
        "contactsIntegration": false
      }
    ]
  }'

Responses

Enterprise created successfully

Bodyapplication/json
enterpriseIdstring
Example: "E0000090"
namestring
Example: "test enterprise2"
contactstring
Example: "Test Contact"
numberstring
Example: "+12223334444"
emailstring(email)
Example: "test@email.com"
deletedboolean
Example: false
createdDatestring(date-time)
Example: "2023-10-29T12:06:17.442Z"
updateDatestring(date-time)
Example: "2023-10-29T12:06:17.443Z"
Response
application/json
{ "enterpriseId": "E0000090", "name": "test enterprise2", "contact": "Test Contact", "number": "+12223334444", "email": "test@email.com", "deleted": false, "createdDate": "2023-10-29T12:06:17.442Z", "updateDate": "2023-10-29T12:06:17.443Z" }

Request

Retrieve full enterprise details (name, contact, number, email, deleted flag, timestamps) for the specified enterpriseId.

Security
BearerAuth
Path
enterpriseIdstringrequired
Example: E0000090
curl -X GET "https://teams-backend.sabrhub.com/enterprise/getenterprise/E0000090" \
  -H "Authorization: Bearer <TOKEN>"

Responses

Successful response

Bodyapplication/json
enterpriseIdstring
Example: "E0000090"
namestring
Example: "test enterprise2"
contactstring
Example: "Test Contact"
numberstring
Example: "+12223334444"
emailstring
Example: "test@example.com"
deletedboolean
Example: false
createdDatestring(date-time)
Example: "2023-10-29T12:06:17.442Z"
updateDatestring(date-time)
Example: "2023-10-29T12:06:17.443Z"
Response
application/json
{ "enterpriseId": "E0000090", "name": "test enterprise2", "contact": "Test Contact", "number": "+12223334444", "email": "test@example.com", "deleted": false, "createdDate": "2023-10-29T12:06:17.442Z", "updateDate": "2023-10-29T12:06:17.443Z" }

Request

Update an existing enterprise with provided details including enterprise features. Use applyToMappings flags in enterpriseFeatures to control whether feature changes should be applied to all existing mappings. Returns the updated enterprise metadata.

Security
BearerAuth
Path
enterpriseIdstringrequired

Unique ID of the enterprise to update

Example: E0000090
Bodyapplication/jsonrequired
namestring
Example: "Updated Enterprise Name"
contactstring
Example: "Updated Contact"
numberstring
Example: "+12223334444"
emailstring(email)
Example: "updated@email.com"
defaultMmsSelectionboolean

Default MMS selection preference

Example: true
enterpriseFeaturesArray of objects

Array of platform-specific enterprise feature configurations with applyToMappings flags

Example: [{"platformType":"Teams","enabled":true,"groupTexting":true,"broadcastTexting":true,"mmsEnabled":false,"teamTexting":true,"scheduleSend":true,"aiSmartReplies":false,"aiChatAssist":false,"cdrAccess":false,"crmIntegration":false,"contactsIntegration":false,"applyToMappings":true,"mmsEnabledApplyToMappings":false,"groupTextingApplyToMappings":false,"broadcastTextingApplyToMappings":false,"teamTextingApplyToMappings":false,"scheduleSendApplyToMappings":false,"aiSmartRepliesApplyToMappings":false,"aiChatAssistApplyToMappings":false,"cdrAccessApplyToMappings":false,"crmIntegrationApplyToMappings":false,"contactsIntegrationApplyToMappings":false}]
curl -X PUT "https://teams-backend.sabrhub.com/enterprise/E0000090" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Enterprise Name",
    "contact": "Updated Contact",
    "number": "+12223334444",
    "email": "updated@email.com",
    "defaultMmsSelection": true,
    "enterpriseFeatures": [
      {
        "platformType": "Teams",
        "enabled": true,
        "groupTexting": true,
        "broadcastTexting": true,
        "mmsEnabled": false,
        "teamTexting": true,
        "scheduleSend": true,
        "aiSmartReplies": false,
        "aiChatAssist": false,
        "cdrAccess": false,
        "crmIntegration": false,
        "contactsIntegration": false,
        "applyToMappings": true,
        "mmsEnabledApplyToMappings": false,
        "groupTextingApplyToMappings": false,
        "broadcastTextingApplyToMappings": false,
        "teamTextingApplyToMappings": false,
        "scheduleSendApplyToMappings": false,
        "aiSmartRepliesApplyToMappings": false,
        "aiChatAssistApplyToMappings": false,
        "cdrAccessApplyToMappings": false,
        "crmIntegrationApplyToMappings": false,
        "contactsIntegrationApplyToMappings": false
      }
    ]
  }'

Responses

Enterprise updated successfully

Bodyapplication/json
enterpriseIdstring
Example: "E0000090"
namestring
Example: "Updated Enterprise Name"
contactstring
Example: "Updated Contact"
numberstring
Example: "+12223334444"
emailstring(email)
Example: "updated@email.com"
deletedboolean
Example: false
createdDatestring(date-time)
Example: "2023-10-29T12:06:17.442Z"
updateDatestring(date-time)
Example: "2023-10-29T15:30:00.000Z"
Response
application/json
{ "enterpriseId": "E0000090", "name": "Updated Enterprise Name", "contact": "Updated Contact", "number": "+12223334444", "email": "updated@email.com", "deleted": false, "createdDate": "2023-10-29T12:06:17.442Z", "updateDate": "2023-10-29T15:30:00.000Z" }

Request

Remove the enterprise identified by enterpriseId. Returns a deletion confirmation or 404 if not found.

Security
BearerAuth
Path
enterpriseIdstringrequired
Example: E0000090
curl -X DELETE "https://teams-backend.sabrhub.com/enterprise/deleteenterprise/E0000090" \
  -H "Authorization: Bearer <TOKEN>"

Responses

Enterprise deleted successfully.

Bodytext/plain
string
Response
No content

Mapping Management

Manage phone number-to-messaging app mappings across enterprises

Operations