Last updated: 3/21/2025 10:48:00 AM
Note
Note
Business role: Distributor (T1), ISP (T1), MSP (T2), and Reseller (T2)
This API is used to create a customer company, encompassed by your partner company, for your end customer.
Note
Note
When the request is processed successfully, you must save the customer ID that the API returns. The customer ID is necessary for further use in customer, user, and subscription management, and for sending customer notifications.

Request

HTTP Request

[POST] /LMPI/v3/customers

Parameters

Request Body

{
  "company" : {
    "name" : "Stay Green Greenery",
    "address" : "160711 Ventura Blvd",
    "city" : "Encino",
    "state" : "CA",
    "postal_code" : "101",
    "country" : "US",
    "note" : "",
    "emergency_email" : "support@trendmicro.com"
  },
  "contact" : {
    "first_name" : "James C",
    "last_name" : "Charlton",
    "email" : "james.c@staygreengreenery.com"
  }
}
Name
Type
Description
Validation
Required Parameters
company.name
string
The name of the customer company.
1-128 characters
company.city
string
The city where the customer company is located.
1-64 characters
company.state
string
The state where the customer company is located.
1-64 characters
company.country
string
The country code where the customer company is located.
ISO 3166-1 alpha-2 country code
contact.first_name
string
The contact person's first name.
1-50 characters
contact.last_name
string
The contact person's last name.
1-50 characters
contact.email
string
The contact email address of the customer company.
1-128 characters with email format (limited to letters, numbers, hyphens, periods, underscores, and "@")
Optional Parameters
company.address
string
The address of the customer company.
0-128 characters
company.postal_code
string
The postal code of the customer company.
0-10 characters
company.industry
string
The industry code of the customer company.
For more information, see Company industry codes.
0-3 characters
company.size
string
The company size code of the customer company.
For more information, see Company size codes.
0-2 characters
company.note
string
Additional notes about the customer company.
0-500 characters
company.emergency_email
string
The emergency contact information, using semicolons to separate multiple email addresses.
Trend Micro uses the emergency contact email if any critical issue of service occurs.
0-250 characters with email format (limited to letters, numbers, hyphens, periods, underscores, and "@")

Response

If successful, this method returns an HTTP 200 OK status code and a response body with the following structure:
{
  "customer_id" : "17363415-4A9F-4A01-8153-10B8F35B50B1"
}
Name
Type
Description
Length
customer_id
string
The unique identifier of the created customer company.
GUID format