Getting Started
Once you've created an API Key, you're ready to start sending data to FullStory.
- User data can be created and modified via the Users API.
- Multiple users can be batch created with the Batch Import Users API.
- Event data can be created with the Events API.
- Multiple events can be batch created with the Batch Import Events API.
API Guarantees​
- Over time, as an anonymous user is identified across multiple devices and via the server API, they will represent a single “logical” user.
- A FullStory-generated user
idwill remain stable and will be guaranteed to reference the same logical user after that user has been identified. - Once a user is identified, a different “id” value may be returned in the server API response of an operation on that user.
- Once a user is identified, the state of their properties collection will represent the most recent state set for that user, even when property values were set when the user was anonymous, prior to being identified.
- This means we will merge existing user properties with new properties being set, and resolve any collisions by taking the most recent value
- Once a server API
uidvalue has been set for a user (i.e. they’ve been identified), that value is immutable and any attempt to update the existing value will result in an error.
Data Residency​
FullStory uses Google Cloud Platform data centers to process and store data. The default data center for all customers is located in the US. As of August 2022, FullStory also has a data center in the European Union (“EU”). Customers now have the option to designate the location of the data center that supports their FullStory account.
All API requests use the api.fullstory.com domain. They are automatically routed to the correct data center based on
what is configured for your FullStory account. You can determine which data center your account is associated with in
one of two ways:
- The FullStory URL you use to login
- https://app.fullstory.com/ uses the
na1data center - https://app.eu1.fullstory.com uses the
eu1data center
- https://app.fullstory.com/ uses the
- The API key you are using for API authentication. The data center used is included as the first
three characters of the API key. If your API key was created prior to August 2022, it may not include this prefix. In
this case, your API key will be associated with the
na1data center.- API key format:
<data center>.<token>
- API key format: