Managed MSP
Call description
This request creates an managed MSP company. EMA 2 places the newly created company underneath the parent company. The parent should always be an MSP manager. The Managed MSP created via this API call is always trusted, meaning that it can order licenses without approval from the parent entity (MSP Manager).
|
Email is mandatory and must be unique within EMA2. Name is mandatory and must be unique within sibling companies. Use the Children call for a list of sibling companies. |
•This API call requires authorization; the user has to be logged in.
•Request URL: https://mspapi.eset.com/api/Company/Create/managedmsp
•This request is a POST call type.
Call structure
Schema
{
"name": "string",
"tags": [
{
"tag": "string"
}
],
"customIdentifier": "string",
"comment": "string",
"vatId": "string",
"description": "string",
"products": [
{
"code": "string"
}
],
"email": "string",
"trialLicenseAllowed": true,
"address": {
"state": "string",
"city": "string",
"streetAddress": "string",
"zipCode": "string"
},
"trusted": true
}
Call parameters
Parameter |
Description |
|---|---|
Email address of the user. For each new Managed MSP a new Contact user is created. Mandatory input parameter. A proper value must be set. |
|
trialLicenseAllowed |
Set if trial licenses are allowed for the new user. Use values: true / false. If you omit this parameter, the value is set to false. |
address |
Section for the user address information. Mandatory input parameter. A proper value must be set. |
state |
User address state of residence. Select one from the list. |
city |
User address city of residence. |
streetAddress |
User address street name. |
zipCode |
User address ZIP code. |
trusted |
Create the Managed MSP as trusted (can order licenses without approval). Allowed values: true / false. |
tags |
Section for the tag listings. |
tag |
Enter one or more tags. The tag is a string. You do not need to define the tag before using it in a call. You can use tags later to search for companies. Setting a tag is not mandatory. If you do not want to use a tag, exclude both tag and tags parameters from the request. |
products |
Section for product codes. Mandatory input parameter. A proper value must be set. |
code |
The product codes are numeric identifiers for ESET products. The list of codes is available using the AvailableProducts call. At least one product code is required. Mandatory input parameter. A proper value must be set. |
customIdentifier |
Identifier string. |
comment |
Comment field. |
vatId |
VAT ID or TAX ID number. If your company has selected USA as the country of residence, it uses TAX ID. The request body always uses VAT ID, but the MSP Web portal (EMA 2) displays the correct field. |
description |
Description field. |
name |
The company name; a unique identifier for entities across EMA 2. Mandatory input parameter. A proper value must be set. |
Response structure
The response contains data in the JSON format.
Troubleshooting
ESET MSP Administrator 2 API uses standardized error codes. If you are getting errors or unexpected responses, see the Troubleshooting API for common problems and the list of error codes.