Working with Service users

How to create a Service User?

In order to create a Service User follow this guide and keep in mind to create and/or add the Service User to the group permissions, with the privileges as needed.

Note: The Service user’s token will be hidden once created, hence keep in mind to keep the Service User credentials, or you will have to refresh the token if lost.

One of the uses of a service user in Bob API is with the Basic type of authentication, as below.

API Error Codes

The most common errors the users can receive, while trying to use this method are as follows:

1. 403 - PERMISSIONS ISSUE

1. Check the Permissions of the service user (In Settings > Roles & Permissions).

2. Check whether the scopes they wish to see are included.

Note: Private Time off will not be included in the response, even the admin can see it in bob.

2. 401 - AUTHENTICATION ISSUE

1. Try to reproduce by using a Service token with similar permissions as their one has as they are trying to receive a response with.

API troubleshooting

1. Collect details about the Service User they are using and how they are trying to receive information (By Bob API or another way?).

2. Which request/call are they trying to use, what is the expected result and what is the response/error they receive?

3. If all the above is provided and there is no way for you to diagnose, please collect the details above, a full request (Including headers will be extremely helpful) and send it to the Integration team to check.