To create an API key:
- Login as an admin and select the appropriate org, if required.
- Click theicon in the top bar > Users in the People section.
- Click Create User.
- Enter the user's name in the First Name and Last Name field.
- Enter an email address in the Email field. If the API key is for a production environment, enter a valid company email address.
- From the Edit User page, click the icon next to All Access to allow the user to view, edit, and delete all data in the org. Alternatively, you may add the user to a role or user group.
- Optional: Click the icon next to Admin to enable administrative rights.
For added security, it's recommended that the Admin setting is not enabled for API users unless admin privileges are needed to complete the required API calls. - Click Create.
- From the Edit User page, record the account's internal ID from the address bar of your browser (e.g., 1732).
- Click theicon in the top bar > Swagger Docs in the Tools section.
- Enter the keyword user in the search text box, then click User from the results to open the Swagger interface in a new tab.
- Scroll down to view the user resource.
- Click GET /user/users/me (who am I?) to expand it.
- Click Try it out!
- Record or copy the id number from the currentOrg section to your clipboard. This is the current org's internal ID.
- Scroll up and expand the org resource to display the available endpoints.
- Click GET /user/org/{orgId}/user/{userId} (load a user org membership) endpoint to expand it.
- Enter the org number copied during step 15 in the orgId field.
- Enter the user ID, copied during step 9 from the Edit User page, in the userId field.
- Click Try it out!
- From the Response Body, record or copy the id number to your clipboard. This is the user's org membership ID number.
- Scroll up and expand the apiKey resource to display the available endpoints.
- Click POST /user/apiKey (create an api key) endpoint to expand it.
- In the Parameters section, click the Example Value box to populate the template in the body text box.
- In the body text box, delete the 0 in the orgUserId attribute, then enter the user's org membership ID number, obtained in step 21.
- Enter a descriptive name for the API key in the name attribute (e.g., Integration Account).
The canImpersonate attribute makes it possible to impersonate another user while using the API key; however, only members of Resolver Support can enable impersonation through the API. Otherwise, setting this attribute to true will result in an error. Contact Resolver Support should you wish to enable this feature. For more information on impersonating a user with an API key, see Impersonation with an API Key. - Click Try it out!
- Copy the apiKey from the Response Body and store it for safekeeping.
For security purposes, once an API key is generated, it cannot be retrieved. If you misplace an API key, a new key must be generated.