Users

The User object represents an individual user in the Marketplace platform. This object contains the following properties:

Field	Type	Description
id	string	Primary user identifier. Example: USR-1671-0642
href	string	Relative reference to the object in the API Example: /v1/accounts/users/USR-1671-0642
email	string	The email address of the user. Example: [e-mail]
status	string	Status of the user. enum values New Invited Invitation Expired Active Blocked Disabled Deleted A user can have the Invited or InvitationExpired status only if they haven't joined the account.
name	string	Name of the user. Example: Will Smith
firstName	string	First name of the user. Example: Will
lastName	string	Last name of the user. Example: Smith
phone	object	Country code and phone number of the user. Example: { "prefix": "+34", "number": "660707172" }
SSO	bool	Flag if a user logs in using SSO. Example: true
acceptedTerms	bool	Flag if the user has accepted the terms and conditions. Example: true
accounts	Account	List of accounts to which the user has been added, not included in the user's account sub-collection. Example: [ { "id": "ACC-1671-0642", "name": "You Are a Test Account" } ]
groups	Group	Groups that the user belongs to. Example: [ { "id": "UGR-5116-6265", "name": "Administrators" }, { "id": "UGR-5116-6565", "name": "Fulfillment Managers" } ]
invitation	object	Added only in context of account (on account sub-collection), and only in case of user being invited. Example: { "code": "910B14E6CB2343A09CB32F24BBC4BEF1", "status": "Invited" }
invitation.code	string	The invitation code sent to user to invite them to the platform. Example: 910B14E6CB2343A09CB32F24BBC4BEF1
invitation.status	string	Invitation status for the user in the account. Example: Invited
audit	object	Represents the audit object. Example: { "created": { ... }, "updated": { ... }, "joined": { ... }, "login": { ... }, "access": { ... } }

Example

USER OBJECT

{
  "id": "USR-6375-2499",
  "email": "[e-mail]",
  "name": "John Smith",
  "firstName": "John",
  "lastName": "Smith",
  "status": "Invited",
  "phone": { 
      "prefix": "+34",
      "number": "660707172"
  },
  "accounts": [
		{
			"id": "ACC-1671-0642",
			"icon": null,
			"name": "You Are a Test Account"
		}
  ],
  "group": [
      {
        "id": "UGR-5116-6265",
        "name": "Administrators"
      },
      {
        "id": "UGR-5116-6565",
        "name": "Fulfillment Managers"
      }
  ],
  "invitation": {
    "code": "910B14E6CB2343A09CB32F24BBC4BEF1",
    "status": "Invited"
  }
}