Domain Data Returned by the roles Service

The REST roles service lets you dynamically discover the following types of domains for any NetSuite account.

Type of Domain

Examples

RESTlet

https://<accountID>.restlets.netsuite.com

System

https://<accountID>.app.netsuite.com

Web services

https://<accountID>.suitetalk.api.netsuite.com

It is important to dynamically discover these domains because, for any NetSuite account, these domains can change. They can change because NetSuite hosts accounts in multiple data centers, and the location of your account can change. Therefore, any integration that includes full URLs must include logic for dynamically discovering these domains. A hard-coded URL could fail.

Note:

Account-specific domains are supported for RESTlets, and you can access your RESTlet domain at the following URL, where <123456> is a variable representing your account ID: <123456>.restlets.api.netsuite.com. For more information, see URLs for Account-Specific Domains.

As of 2020.1, when you call the REST roles service on an account specific domain, only the account specific information is returned. All roles are returned for the user, including the Customer Center roles, and any roles created based on the Customer Center role.

Related Topics

General Notices