Skip to main contentIBM Maximo REST API Guide

Creating a Multi-tenant Tenant using the REST api

You can create an object structure (say MXAPITENANTREG) with the tenantdbuserid attribute restricted and include the newusergroup and the docroot non-persistent attributes.

The following example shows a POST request to create a tenant:

POST /oslc/os/mxapitenantreg

Body:

{
"tenantcode": "MYTEST00",
"description": "my test 00 tenant",
"company": "test00comp",
"firstname": "mytest00",
"lastname": "Bhat",
"primaryemail": "abc@us.ibm.com",
"tenantloginid": "myabc123",
"tenantdbuserid": "T11",

This POST creates the tenant and the tenant admin with the login ID of myabc123. Also, an email is sent to the primary email address with the generated password. You must make sure that the smtp host is setup for this. If the application server security is enabled, then this smtp setup may not be needed as the password management is done outside of Maximo Asset Managemnt. Note an MT tenant cannot be created without the tenant admin. Also, note that this API needs to be invoked in the context of MT landlord.