Documentation

Deprecated

Announced Jun 1, 2020: APIs under the ECom.Licenses scope are scheduled for End of Life effective December 1, 2020. At that time this API will no longer be available. Please see ECom.Shop (e.g. Create Trial) for the next generation Ecommerce API functionality.

POST /service/api/ecom/licenses/createTrial

Creates a trial license.

Request Information

URI Parameters

None.

URI Sample(s)

POST	https://unityapi.webrootcloudav.com/service/api/ecom/licenses/createTrial

Body Parameters

CreateTrialRequestServiceModel

Name	Description	Type	Additional Information
CustomerEmail	The email address.	string	Required
LanguageCode	The ISO two-letter language code.	string	None.
LocationCode	The ISO three-letter country code.	string	None.
PartnerProductId	The product id.	string	Required
Seats	The number of seats on the trial license.	integer	Required
Country	The ISO three-letter country code.	string	Required
ExternalAccountId	The account number of the customer.	string	Required
Modules	The modules (e.g. DNS Protection or WSAT) to allocate with this license.	Collection of CreateTrialRequestServiceModel_Module	None.

Sample Request

{
  "Modules": [
    {
      "Code": "DNS",
      "Seats": 50
    },
    {
      "Code": "WSAT",
      "Seats": 50
    }
  ],
  "CustomerEmail": "jdoe@incorporated.com",
  "LanguageCode": "EN",
  "LocationCode": "USA",
  "PartnerProductId": "113400101",
  "Seats": 50,
  "Country": "USA",
  "ExternalAccountId": "MyAccountRef6003"
}

<CreateTrialRequestServiceModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.ECom.Models">
  <Country>USA</Country>
  <CustomerEmail>jdoe@incorporated.com</CustomerEmail>
  <ExternalAccountId>MyAccountRef6003</ExternalAccountId>
  <LanguageCode>EN</LanguageCode>
  <LocationCode>USA</LocationCode>
  <Modules>
    <CreateTrialRequestServiceModel_Module>
      <Code>DNS</Code>
      <Seats>50</Seats>
    </CreateTrialRequestServiceModel_Module>
    <CreateTrialRequestServiceModel_Module>
      <Code>WSAT</Code>
      <Seats>50</Seats>
    </CreateTrialRequestServiceModel_Module>
  </Modules>
  <PartnerProductId>113400101</PartnerProductId>
  <Seats>50</Seats>
</CreateTrialRequestServiceModel>

Response Information

Resource Description

Details about the created trial license.

CreateTrialResponseServiceModel

Name	Description	Type	Additional Information
License	The License element.	CreateTrialResponseServiceModel_License	None.

Sample Response

{
  "License": {
    "LicenseId": 103139968,
    "Keycode": "998FB437C2B04BA1A966",
    "ExternalAccountId": "MyAccountRef1486",
    "Seats": 50,
    "SeatsUsed": 0,
    "StorageGb": 50.0,
    "StartDate": "2024-12-21T16:39:12.8660271Z",
    "ExpirationDate": "2025-12-21T16:39:12.8660271Z",
    "Modules": [
      {
        "Seats": 50,
        "Name": "DNS Protection",
        "Code": "DNS",
        "LicenseType": "trial",
        "StartDate": "2024-12-21T16:39:12.8660271Z",
        "ExpirationDate": "2025-12-21T16:39:12.8660271Z"
      },
      {
        "Seats": 50,
        "Name": "Webroot Security Awareness Training",
        "Code": "WSAT",
        "LicenseType": "trial",
        "StartDate": "2024-12-21T16:39:12.8660271Z",
        "ExpirationDate": "2025-12-21T16:39:12.8660271Z"
      }
    ]
  }
}

<CreateTrialResponseServiceModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.ECom.Models">
  <License>
    <ExpirationDate>2025-12-21T16:39:12.8660271Z</ExpirationDate>
    <ExternalAccountId>MyAccountRef1486</ExternalAccountId>
    <Keycode>998FB437C2B04BA1A966</Keycode>
    <LicenseId>103139968</LicenseId>
    <Modules>
      <CreateTrialResponseServiceModel_Module>
        <Code>DNS</Code>
        <ExpirationDate>2025-12-21T16:39:12.8660271Z</ExpirationDate>
        <LicenseType>trial</LicenseType>
        <Name>DNS Protection</Name>
        <Seats>50</Seats>
        <StartDate>2024-12-21T16:39:12.8660271Z</StartDate>
      </CreateTrialResponseServiceModel_Module>
      <CreateTrialResponseServiceModel_Module>
        <Code>WSAT</Code>
        <ExpirationDate>2025-12-21T16:39:12.8660271Z</ExpirationDate>
        <LicenseType>trial</LicenseType>
        <Name>Webroot Security Awareness Training</Name>
        <Seats>50</Seats>
        <StartDate>2024-12-21T16:39:12.8660271Z</StartDate>
      </CreateTrialResponseServiceModel_Module>
    </Modules>
    <Seats>50</Seats>
    <SeatsUsed>0</SeatsUsed>
    <StartDate>2024-12-21T16:39:12.8660271Z</StartDate>
    <StorageGb>50</StorageGb>
  </License>
</CreateTrialResponseServiceModel>