User Field Categories

Last modified on August 24, 2023 at 8:09 pm

Resource URL


In order to create userfields for capturing user information, you must create a userfield and specify the category in that call. Any category name that does not exist will be added as a new category. This will be reflected in the user interface as a category heading above the userfield prompt and entry areas, visually grouping together userfields which belong to the same category. A userfield can only be in one category.

There are two types of categories: public and private. These allow administrators to use one system to capture and manage user information, but only public categories are visible to the end user. Userfields placed into private categories are only visible to and modifiable by your organization’s administrators.

You can find details of the JSON representation of userfield categories by referring to the Userfield Category Object Reference.

Use Case Examples

GET Requests

Retrieve all userfield category dataGET /api/v5/userfieldcategoriesRetrieve all userfield category data.
Retrieve a specific userfield categoryGET /api/v5/userfieldcategoriesRetrieve all data about a specific userfield category identified by {id}.

DELETE Requests

Delete a userfield categoryDELETE /api/v5/userfieldcategories/{userfieldcategoryId}Remove a userfield category from the system