IAM user endpoint

[#1]

• User endpoint

User endpoint

The user endpoint supports the retrieval of users and to set an identity for a user, the following methods are supported as part of the users endpoint.

https://api.youforce.com/iam/v1.0/users

GET

Allows retrieving a single employee based on employeeId for the tenant specified in the request header.

https://api.youforce.com/iam/v1.0/users(employeeId=12345)

Supports the following parameter as part of the resource path:

• employeeId - The unique id assigned to an employee

Returns a 200 OKwhen successful

PATCH

Allows to update or set an identity for a specific user based on employeeId for the tenant specified in the request header.

https://api.youforce.com/iam/v1.0/users(employeeId=12345)/identity

Supports the following parameters as part of its request body:

• id- Ping Id of the employee which is to be used for SSO

{
    "id": "user@customer.com"
}

Returns a 204 No content when successful
Returns a 404 when the user account doesn't exists

Visibility of the change in Youforce portal

Please note that updating the identity through this endpoint

• will update the identity in the Youforce authentication system

• will NOT show the values in Youforce portal

Our authentication system is not running on the same service as the portal UI. The synchronization is just one way:

• Changes done in the authentication system direct will not reflect in the Youforce portal UI

• Changes done in this UI will reflect in the authentication system

This will be addressed in future, when we merge the two services.

Datamapping

Parameters	Description	Example	Data type
employeeId	The unique id assigned to the employee by the HR Core	12345	string
id	User id of the employee used in the Youforce authentication system	c7e230db-2a7f-4ef0-ad1d-9d30e7d94a2f	string
sourceId	Username of the user in the Youforce portal	XX123456	string
identityId	UPN/Identity in the customer authentication system that takes care of authentication Note: Only email format is supported	user@customer.com	string

[FBB Zorgboog]

@René Sanders is bovenstaande informatie nog steeds actueel? Is een dmv de API gevulde Identity nog steeds niet zichtbaar in Youforce portal? En zo nee, hoe kunnen we dan controleren of e.e.a. naar wens verloopt?