# Add phone-to-app mapping

Create a number→messaging-app mapping for the specified enterprise. Returns the mapping id and mapping details.

Endpoint: POST /mapping/add/{enterpriseId}
Version: 1.0.0
Security: BearerAuth

## Path parameters:

  - `enterpriseId` (string, required)
    Example: "E0000027"

## Request fields (application/json):

  - `phoneNumber` (string, required)
    Example: "+12223334444"

  - `messagingAppType` (string, required)
    Enum: "Teams"

  - `messagingAppId` (string, required)
    Example: "test@example.com"

  - `name` (string, required)
    Example: "Tester"

  - `mmsEnabled` (boolean)

  - `mappingFeatures` (array)
    Array of platform-specific feature configurations
    Example: [{"platformType":"Teams","enabled":true,"groupTexting":false,"broadcastTexting":false,"mmsEnabled":false,"teamTexting":true,"scheduleSend":false,"aiSmartReplies":false,"aiChatAssist":false,"cdrAccess":false,"crmIntegration":false,"contactsIntegration":false},{"platformType":"Webex","enabled":true,"groupTexting":false,"broadcastTexting":false,"mmsEnabled":false,"teamTexting":true,"scheduleSend":false,"aiSmartReplies":false,"aiChatAssist":false,"cdrAccess":false,"crmIntegration":false,"contactsIntegration":false}]

  - `mappingFeatures.platformType` (string)
    Enum: "Teams", "Webex"

  - `mappingFeatures.enabled` (boolean)
    Example: true

  - `mappingFeatures.groupTexting` (boolean)

  - `mappingFeatures.broadcastTexting` (boolean)

  - `mappingFeatures.teamTexting` (boolean)
    Example: true

  - `mappingFeatures.scheduleSend` (boolean)

  - `mappingFeatures.aiSmartReplies` (boolean)

  - `mappingFeatures.aiChatAssist` (boolean)

  - `mappingFeatures.cdrAccess` (boolean)

  - `mappingFeatures.crmIntegration` (boolean)

  - `mappingFeatures.contactsIntegration` (boolean)

  - `notifyUser` (boolean)
    Whether to notify the user via email
    Example: true

  - `emailNotifyMap` (object)
    Map of email addresses to notification preferences
    Example: {"test222@gmail.com":false}

## Response 201 fields (application/json):

  - `numberToMessageAppMapId` (string)
    Example: "NTMAP0000123"

  - `phoneNumber` (string)
    Example: "+12223334444"

  - `messagingAppType` (string)
    Example: "Teams"

  - `messagingAppId` (string)
    Example: "test@example.com"

  - `name` (string)
    Example: "Tester"

  - `mmsEnabled` (boolean)

  - `status` (string)
    Example: "ACTIVE"

  - `createdDate` (string)

  - `updateDate` (string)

## Response 400 fields (application/json):

  - `fields` (string)

  - `message` (string)


## Response 403 fields

## Response 500 fields