HTTP API - Sending users to FullStory with a server-to-server call
User data often lives in many different systems across your organization. For example, perhaps you’re using a CDP, ERP, CRM, or reverse ETL tool. With the Users API, you can create users and pass user properties into FullStory on your schedule, not only when users are interacting with your properties. This allows you to integrate data from these platforms and gain a more complete view of your customer experience.
Using the API
Please see the Users API Developer Documentation for more detailed information about how to use this API.
Using custom user properties in FullStory
After you send custom user properties to FullStory, the properties will display on related user cards.
You can also search for user properties easily. Just look for the property name under “User Filters” when building your search.
To control which properties are available in Search, Admin or Architect users can archive custom user properties under Settings > Data Management > Properties.
Note: You can configure up to 500 unique user properties.
Why would I use this API instead of FS.setUserVars?
The FS.setUserVars API is designed for sending client-side user properties to FullStory. Client-side user properties are present in the browser at the time the session is captured. On the other hand, this API allows you to send server-side user properties, or properties that aren’t available in the browser. This opens up more opportunity for integrating with behind-the-scenes systems across your organization.
Does the user have to already exist in FullStory or will a request with a new ‘uid’ create a new user record?
You can create users directly via server-side API call. You have the option to create a user with an identified user id (uid) or create the user as an anonymous user by excluding the uid from the request. If you create an anonymous user, FullStory will generate an anonymous user id (id) and return it in the response. Either of these ids can be used in subsequent API requests to set and update properties for the user.
Does this API support batch/bulk updates?
Yes, FullStory also offers a batch Users API that allows you to create or update large sets of users in one request. Check out the batch users documentation for details on how to format the exact request.