[Index]

API Reference for view/AddSubscriberFromProfile

View to add a Subscriber using a Service Profile.

Model ref.: view/AddSubscriberFromProfile

The full URL would include the host-proxy name: https://[host-proxy].

Variables are enclosed in square brackets.

[hierarchy] is the hierarchy.
1. as UUID. For example: 6t0ggef2c0deab00hb595101
2. in dot notation. E.g. ProviderName.CustomerName.LocationName

For [auth_token]:
1. The VOSS portal will extract the [auth_token] from the URLs and send these as an Authorization header.
2. Model schemas show that the auth_token parameter is still supported.

For a list of available UUIDs and their dot notations:
GET /api/v0/data/HierarchyNode/?format=json

[pkid] is the ID of the resource instance. Refer to the List reference below.
[filename] refers to a file

GET http://[host-proxy]/api/view/AddSubscriberFromProfile/schema/?hierarchy=[hierarchy]&format=json&schema=1

        {
     "$schema": "http://json-schema.org/draft-03/schema",
     "type": "object",
     "properties": {
          "cucm_bkey": {
               "title": "CUCM bkey",
               "description": "Business Key of the CUCM.",
               "type": "string",
               "required": false
          },
          "username": {
               "title": "Username",
               "description": "Username of the subscriber.",
               "type": "string",
               "required": true
          },
          "firstname": {
               "title": "First Name",
               "description": "First name of the subscriber.",
               "type": "string"
          },
          "lastname": {
               "title": "Last Name",
               "description": "Last name of the subscriber.",
               "type": "string",
               "required": true
          },
          "email": {
               "title": "Email Address",
               "description": "Email address of the subscriber.",
               "type": "string",
               "required": false,
               "pattern": "^([^.@]+)(\\.[^.@]+)*@([^.@]+\\.)+([^.@]+)$"
          },
          "send_email": {
               "title": "Send welcome email",
               "description": "Send Email to user using predefined HTML Email Template. Email template used is 'Quick Add Subscriber'",
               "type": "boolean"
          },
          "send_email_flag": {
               "title": "Send Email to user flag",
               "description": "Send Email to user using predefined HTML Email Template. Email template used is 'Quick Add Subscriber'",
               "type": "boolean"
          },
          "mobile_number": {
               "title": "Mobile Number",
               "description": "Mobile number of the subscriber.",
               "type": "string",
               "pattern": "^(\\+?[0-9]*)$"
          },
          "password": {
               "title": "Password",
               "description": "The corresponding CUCM, CUC and WebEx user password will be set with this password",
               "type": "string",
               "is_password": true,
               "required": false
          },
          "pin": {
               "title": "PIN",
               "description": "The corresponding CUCM and CUC user PIN will be set with this PIN",
               "type": "string",
               "is_password": true,
               "required": false
          },
          "generate_phone_name": {
               "title": "Use generated phone name",
               "description": "A random phone name will be generated by the system. This is only applicable if the selected Subscriber Profile has the Voice service enabled.",
               "type": "boolean",
               "default": "true"
          },
          "phone_name": {
               "title": "Phone Name",
               "description": "Name to be used when provisioning a phone for e.g. SEPAABBCCDDEEFF. The specific format is dependent on the phone type specified in the profile configuration. This is only applicable if the selected Subscriber Profile has the Voice service enabled.",
               "type": "string"
          },
          "automatic_line": {
               "title": "Use next available line",
               "description": "Use the next available line from the inventory.",
               "type": "boolean",
               "default": "true"
          },
          "line_filter": {
               "title": "Inventory Filter",
               "type": "string",
               "required": false
          },
          "line": {
               "title": "Line",
               "description": "The line number to use for this subscriber.",
               "type": "string"
          },
          "subscriber_profile": {
               "title": "Subscriber Profile",
               "description": "The profile to use for subscriber configuration.",
               "type": "string",
               "required": true
          },
          "ldap_user": {
               "title": "LDAP User",
               "description": "The LDAP user field.",
               "type": "string"
          },
          "cucm_user_ldapDirectoryName": {
               "title": "CUCM User LDAP Directory Name",
               "description": "The CUCM User LDAP directory name field.",
               "type": "string"
          },
          "cucm_user": {
               "title": "CUCM User",
               "description": "The CUCM User field.",
               "type": "string"
          },
          "username_ms_365": {
               "title": "O365 User",
               "description": "The O365 User field.",
               "type": "string"
          },
          "username_ms_teams": {
               "title": "MS Teams User",
               "description": "The MS Teams User field.",
               "type": "string"
          },
          "new_services_status": {
               "title": "New Services status field",
               "description": "New Services status field.",
               "type": "boolean"
          },
          "existing": {
               "title": "Existing Services",
               "description": "Subscriber's existing services.",
               "type": "object",
               "properties": {
                    "phones": {
                         "title": "Phones",
                         "type": "string"
                    },
                    "ext_mobilities": {
                         "title": "Extension Mobility Profile",
                         "type": "string"
                    },
                    "voicemail": {
                         "title": "Voicemail Extension",
                         "type": "string"
                    },
                    "webex": {
                         "title": "Webex Meetings",
                         "type": "string"
                    },
                    "snr": {
                         "title": "Single Number Reach",
                         "type": "string"
                    },
                    "spark": {
                         "title": "Webex App",
                         "type": "string"
                    },
                    "pexip": {
                         "title": "Pexip Conferencing",
                         "type": "string"
                    },
                    "contact_center": {
                         "title": "Contact Center",
                         "type": "string"
                    },
                    "microsoft_hosted_voice_mail": {
                         "title": "Microsoft Hosted Voicemail",
                         "type": "string"
                    },
                    "microsoft_enterprise_voice_enabled": {
                         "title": "Microsoft Teams Phone System",
                         "type": "string"
                    },
                    "hybrid": {
                         "title": "Hybrid Service",
                         "type": "string"
                    }
               }
          },
          "subscriber_profile_services": {
               "title": "New Services",
               "description": "Subscriber Profile Services that will be added.",
               "type": "object",
               "properties": {
                    "line": {
                         "title": "Line",
                         "type": "string"
                    },
                    "phone": {
                         "title": "Phone",
                         "type": "string"
                    },
                    "jabber_iphone": {
                         "title": "Jabber (iPhone)",
                         "type": "string"
                    },
                    "jabber_android": {
                         "title": "Jabber (Android)",
                         "type": "string"
                    },
                    "jabber_tablet": {
                         "title": "Jabber (Tablet)",
                         "type": "string"
                    },
                    "jabber_csf": {
                         "title": "Jabber (CSF)",
                         "type": "string"
                    },
                    "jabber_cim": {
                         "title": "Jabber (CIM)",
                         "type": "string"
                    },
                    "jabber_cti": {
                         "title": "Jabber (CTI)",
                         "type": "string"
                    },
                    "ext_mobilities": {
                         "title": "Extension Mobility Profile",
                         "type": "string"
                    },
                    "voicemail": {
                         "title": "Voicemail Extension",
                         "type": "string"
                    },
                    "webex": {
                         "title": "WebEx",
                         "type": "string"
                    },
                    "snr": {
                         "title": "Single Number Reach",
                         "type": "string"
                    },
                    "spark": {
                         "title": "Webex App",
                         "type": "string"
                    },
                    "webex_calling": {
                         "title": "Webex Calling",
                         "type": "string"
                    },
                    "pexip": {
                         "title": "Pexip Conferencing",
                         "type": "string"
                    },
                    "contact_center": {
                         "title": "Contact Center",
                         "type": "string"
                    },
                    "microsoft_hosted_voice_mail": {
                         "title": "Microsoft Hosted Voicemail",
                         "type": "string"
                    },
                    "microsoft_enterprise_voice_enabled": {
                         "title": "Microsoft Teams Phone System",
                         "type": "string"
                    }
               }
          }
     },
     "schema_version": "2.2"
}

Task	Call	URL	Parameters	Response
Get the GUI Add form.	GET	/api/view/AddSubscriberFromProfile/add/	hierarchy=[hierarchy] format=json	The GUI Add form of view/AddSubscriberFromProfile as JSON

The API call to the /add/ URL can only be made from a hierarchy that allows the model type to be added. The actions in the response shows the url for the POST API call to create an instance.

Task	Call	URL	Parameters	Payload
Create	POST	/api/view/AddSubscriberFromProfile	hierarchy=[hierarchy]	(For payload specification)

Response is a transaction pkid for the create action.

The GET call to

tool/Transaction/[trans pkid]

shows the View resource has no instance pkid, because a view model stores no instances.

Task	Call	URL	Parameters	Response
Get a compressed format of the Bulk Load spreadsheet template for view/AddSubscriberFromProfile	POST	/api/view/AddSubscriberFromProfile/export_bulkload_template/	hierarchy=[hierarchy] modeltype=view/AddSubscriberFromProfile	The response is an attachment of the format: filetype_bulkloadsheet.xlsx.gz

Task	Call	URL	Parameters	Response
Configuration Template	GET	/api/view/AddSubscriberFromProfile/configuration_template/	hierarchy=[hierarchy]	POST call to create the Configuration Template Configuration Template schema

Use the returned properties to create the POST payload data for the .
For a description of the schema that shows properties to add to the POST payload:

The POST call is of the format:

POST http://[host-proxy]/api/data/ConfigurationTemplate/?hierarchy=[hierarchy]

Task	Call	URL	Parameters	Response
Field Display Policy	GET	/api/view/AddSubscriberFromProfile/field_display_policy/	hierarchy=[hierarchy]	POST call to create the Field Display Policy Field Display Policy schema

Use the returned properties to create the POST payload data for the .
For a description of the schema that shows properties to add to the POST payload:

The POST call is of the format:

POST http://[host-proxy]/api/data/FieldDisplayPolicy/?hierarchy=[hierarchy]

Task	Call	URL	Parameters	Response
Get the on-line Help for view/AddSubscriberFromProfile.	GET	/api/view/AddSubscriberFromProfile/help	hierarchy=[hierarchy]	On-line help of Model ref.: view/AddSubscriberFromProfile as HTML

Instance API Reference

[pkid] is the ID of the resource instance.
If a payload is required, inspect the schema for payload details.

Task	Call	URL	Parameters	Response
Get	GET	/api/view/AddSubscriberFromProfile/[pkid]	hierarchy=[hierarchy]	The view/AddSubscriberFromProfile instance with [pkid].

Task	Call	URL	Parameters	Response
Help	GET	/api/view/AddSubscriberFromProfile/[pkid]/help	hierarchy=[hierarchy]	The on-line Help for view/AddSubscriberFromProfile.

API Reference for view/AddSubscriberFromProfile

GET http://[host-proxy]/api/view/AddSubscriberFromProfile/schema/?hierarchy=[hierarchy]&format=json&schema=1

Get the Add form

Create

Export Bulk Load Template

Configuration Template

Field Display Policy

Help

Instance API Reference

Get

Help