Learn how to assign a unique external identifier (UUID) to an account in Trustform to enable API access and ensure smooth data integration.
Overview
Every account in Trustform can have an external unique identifier (UUID). This identifier is essential for retrieving data via the API and needs to be set manually. It helps maintain consistent data and smooth integration across systems.
Add Account ID Information
To assign a UUID to an account, follow these steps:
1
Find the UUID field
Go to the Accounts section and select the account you want to update. Look under the account title for the message Account ID is not set, then click the Edit button.
2
Enter the unique identifier (UUID)
Add a UUID that is unique across all accounts. You can use letters, numbers, or special characters. Click the checkmark next to the UUID field to confirm the changes.
Notes
A UUID is required for API access – without it, you cannot retrieve object data
Every UUID must be unique – the platform will not allow duplicates
You can update the UUID later if needed
Setting Object UUIDs – Best Practice
When creating or referencing objects in Trustform, it is important to use consistent and meaningful UUIDs (unique identifiers) to ensure data integrity and easy traceability across your systems.
Best Practices for UUID Creation
A consistent approach to UUIDs ensures accuracy and simplifies integration. Here is how to keep them clean and predictable:
Use stable values that do not change (for example, internal database ID or official registration number)
Keep UUIDs globally unique across your organisation or data scope
Avoid using personal data such as names or emails for privacy reasons
Stick to a simple format, for example acct-12345 or profile_US_001
Ensure they are predictable but not easily guessable when exposed externally
