Create Custom Company Settings


This endpoint can be used to add a new custom company setting to a specific company.

To consume the endpoint, you must:

  • Be an authenticated user.

For information on how you can authenticate, see Authentication.

After you authenticate and receive a valid token, you must pass it to service calls.


An example of this endpoint for XX server is:


For your server, the endpoint will be:

  • https://{your_server_id}{id}/CustomSettings


  • Method Type: HttpPost
  • Authorization: Use Bearer Token + token received from token authentication
  • Header info: Content-Type: application/json

Request Body

One custom company setting has to be provided in the request. The body parameters are used to define the setting’s name, value, and masking.

ParameterParameter TypeData TypeDescriptionRequired
idpathintegerID of the targeted company.yes
SettingNamebodystringCustom company setting name.yes
SettingValuebodystringCustom company setting value.

Set to “null” if no update is needed.

MaskValuebodybooleanShow or hide the setting value.

Set to “null” if no update is needed


The request body should be formatted as follows:


  • If the user is authenticated and the request is successful, the response is Status Code 200 => OK
  • If the user is not authenticated, the response is Status Code 401 => Invalid Token
  • In case of an error, the response is Status Code 500 => Internal Server Error
  • In case of an incorrect request, the response is Status Code 400 => Bad Request

Was this article helpful?

Get Custom Company Settings