Identity Cloud uses its own terminology when referring to user accounts and to the databases where user account information is stored. In Identity Cloud, the term entity is used when referencing user accounts and user profiles. As you might expect then, the /entity.create operation is used to create user accounts and the /entity.find operation is used to search for user accounts.

Similarly, a database that maintains user accounts is known as an entity type. When you first subscribe to Identity Cloud, you’re given a single entity type: user. Although the user entity type is predefined for you, you can use the Entity and Entity Type API to customize the database as you see fit. For example, you might add a database field (more-commonly referred to as an entity type attribute) to store a user’s favorite color or the name of their favorite baseball team. You can also use the API to create additional entity types using the aptly named /entityType.create operation. This enables you to do such things as have one entity type to store account information for your North American users and a second entity type to store account information for your South American users.


The Entity and Entity Types API uses the following syntax for operation URLs:


To access the API operations, replace {registrationDomain} with the name of your Identity Cloud Capture domain, and replace {operation} with the appropriate operation name. For example: