Provision Customer Organization Task Flow (via API)

Complete these tasks to provision new customer organizations and to add users to those organizations.
You can also use Partner Hub to provision customer organizations. See Provision Customer Organization Task Flow (via Partner Hub).
During provisioning, whether in Partner Hub or via API, the SIP domain for customer organizations is now automatically set. This update ensures the SIP domain is configured correctly, which is necessary for creating a workspace when using Webex Calling.
1

Configure a Onboarding Template

Before you provision a customer, you must have set up a Onboarding template in Partner Hub. You can use an existing template or create a new one.

2

Provision Wholesale Customer API

Provision the customer organization using APIs. Apply the Onboarding template settings to your new customer organization.

3

Provision Wholesale Subscribers API

Add subscribers (users) to the customer organization using APIs.

Provision Wholesale Customer API

Use this procedure to provision a new Wholesale customer organization using the provisioning API.

Before you begin

The Onboarding Template must exist already in Partner Hub. When provisioning the customer, you'll need to input the value of the provisioningID field from the template that you want to use. For details, see Configure a Onboarding Template.

For more information on supported languages, see: Supported Language Locales

1

Open the Provision a Wholesale Customer API.

2

In the configuration area on the right, complete the required fields for the customer org. Make sure to follow the format in the examples:

  • provisioningID—Enter the ID that is associated to the Onboarding Template that you want to use.
  • Packages—Enter the packages that you want to provision (for example, common_area_calling, webex_calling, webex_suite, webex_meetings)
  • orgID—If you're attaching this org to an existing org, enter the orgID.
  • externalID—For new orgs, enter any text for the external ID.
  • Address—Enter the address in the requested format. The organization country will determine the default global call-in numbers in Webex Meetings site with Cisco enabled PSTN calling options. Refer to the Address section of help page for more information.
  • customerInfo – Input the required info (e.g, name and primary email) for this customer.
  • provisioningParameters—Optional. Enter the provisioning parameters that you want to set. See the Developer site for a list of parameters that you can enter.
  • billingStartDate—Optional. Billing start date for a customer. Partner can set a date on which their customer's billing should start and it must not be more than 90 days. Only applicable if a partner has the `enable_wholesale_delayed_billing' setting enabled.
3

Click Run.

The result displays in the Response window. The response also contains a URL that displays in the Location header and which points to the organization.

What to do next

Provision Wholesale subscribers to the customer organization.

Provision Wholesale Subscribers API

Use this procedure to add subscribers (users) to a customer organization using the provisioning API.
The first provisioned user into a new customer organization gets assigned administrator privileges automatically.
1

Open the Provision a Wholesale Subscriber API.

2

Complete the following required fields. For additional information on the fields, refer to the field descriptions with the API:

  • customerID—Enter the customerID of the customer to whom the subscriber is to be proviisoned
  • email—Enter the email of the subscriber. Note that the fiirst user provisioned to the org is an Admin user.
  • Package—Enter the packages (for example, attendant_console, customer_assist, webex_calling, webex_calling_standard, webex_meetings, and webex_suite.
  • provisioningParameters—The firstname and lastName parameters are mandatory. For calling packages, it's also mandatory to provision either extension or primaryPhoneNumber.
The LocationId provisioning parameter is applicable to calling packages only. This field can be used if you are attaching this subscriber to an existing customer organization that has multiple locations. This field lets you specify the proper location.
3

Click Run.

4

Repeat these steps to provision additional subscribers.

If you are providing Control Hub acccess to customer organizations, you can also assign roles to the customer administrators. See Assign organization account roles in Control Hub.

What to do next

Optional. If you are using the Wholesale Setup Assist service, Submit Wholesale Setup Assist Request Form.