questionuser_id & klaim_id

Overview

When managing user identities in our system, we use two key identifiers:

klaim_id (Internal Identifier)

  • This is a unique identifier automatically generated by Klaim.

  • It is used internally to reference the user across our systems.

  • You can think of it as a system-assigned ID that always exists, even if you don’t provide your own user ID.

user_id (Your Custom Identifier)

  • This is an optional, user-defined identifier.

  • If you want to associate your own user ID with a record (e.g. email address, UUID from your own database), you can pass it as user_id when creating or updating a user.


How They Work Together

  • If you provide a user_id, we will store it and you can use it later to query or filter data.

  • If you don’t provide a user_id, the system will fall back to using the klaim_id as the identifier in most APIs.

In short: If user_id is present → used as your custom identifier If not → klaim_id is used as the fallback identifier


Example


Recommendation

We strongly recommend providing your own user_id:

  • It makes your data easier to manage and debug.

  • It helps when correlating records across different systems.

But if you don’t, don’t worry — we’ll still handle everything using the system-generated klaim_id.


Last updated