Setting Account IDs

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

Why It Matters

Consistent and meaningful UUIDs allow you to:

  • Reference objects reliably across API calls

  • Prevent duplication errors

  • Integrate with external systems more efficiently

PreviousAdding Nominated AccountsNextKYC/AML checks

Last updated