Relesys API Docs

v1.3

https://api.relesysapp.net/api/v1.3

Welcome

Introduction Getting access

Concepts

Scopes HTTP Status Codes Request Throttling Pagination Filtering Sorting Patch Requests Permissions Notifications Markdown Syntax Module Settings

Endpoints

Users

Create User
POST /users 
https://api.relesysapp.net/api/v1.3/users
Create a user if the model is valid.

customFields is an array of key-value-pairs referencing the externalId (see the documentation for 'Get User Custom Fields') as the key, and a string input as the value.
Scopes: relesys.api, relesys.api:write, relesys.api.users, relesys.api.users:write
Request Body
application/json
object
  ⯈ additionalDepartments array[object] optional
   dataSource string optional
   id string / guid optional
  birthDate datetime optional
  customFields dictionary`2 optional
  dataSource string optional
  email string optional
  employmentDate datetime optional
  employmentEndDate datetime optional
  externalId string optional
  name string required
  password string optional
  ⯈ phoneNumber object optional
   countryCode integer optional
   number string optional
  primaryDepartmentId string / guid required
  secondaryEmail string optional
  ⯈ secondaryPhoneNumber object optional
   countryCode integer optional
   number string optional
  title string optional
  ⯈ userGroups array[object] required
   dataSource string optional
   id string / guid optional
  userName string optional
Responses
application/json
201
Schema Example
JSON
{"data":{"id":"454c5f10-ea7c-496d-adad-3db8bb52451d","url":null,"departmentUrl":null,"status":"Activated","creationDateTime":"2025-10-26T22:30:33.3540789Z","lastModifiedDateTime":"2025-10-26T22:30:33.3540789Z","externalId":"NUA","name":"New User A","userName":"UserNameA","title":"User Title A","dataSource":"RelesysAPI","email":"personalmaila@testmail.com","secondaryEmail":"businessmaila@testmail.com","phoneNumber":{"countryCode":45,"number":"12345678"},"secondaryPhoneNumber":{"countryCode":45,"number":"12345679"},"birthDate":"2002-12-30T00:00:00Z","primaryDepartmentId":"6f1325bb-91cb-40d6-b9ee-37b4ceee8ad6","additionalDepartments":[{"id":"82ee73c6-fe2f-4894-9848-29f0a8e65b06","dataSource":"RelesysAPI"}],"userGroups":[{"id":"6fc6d457-c749-4aea-a4e8-5106c3868139","dataSource":"RelesysAPI"},{"id":"2f2b4195-43e9-437d-83c6-59c572825064","dataSource":"RelesysAPI"}],"employmentDate":"2018-12-30T13:30:00Z","employmentEndDate":"2021-12-30T13:30:00Z","customFields":{"customfieldone":"Custom field 1","customfieldtwo":"Custom field 2","customfieldthree":"Custom field 3"}}}
object
  ⯈ data object      
   ⯈ additionalDepartments array[object]      
    dataSource string      
    id string / guid      
   birthDate datetime      
   customFields dictionary`2      
   dataSource string      
   departmentUrl string      
   email string      
   employmentDate datetime      
   employmentEndDate datetime      
   externalId string      
   id string / guid      
   name string      
   ⯈ phoneNumber object      
    countryCode integer      
    number string      
   primaryDepartmentId string / guid      
   secondaryEmail string      
   ⯈ secondaryPhoneNumber object      
    countryCode integer      
    number string      
   status string      
   title string      
   url string      
   ⯈ userGroups array[object]      
    dataSource string      
    id string / guid      
   userName string