GenesisForums
Documentation navigation

Identity and timestamps

How imported authors later link to Genesis and how source time is represented.

Identity resolution

The pair integration + external UUID identifies the imported author. Use the same UUID in comment ingestion and account linking. Once linked, Genesis associates that external identity with the authenticated Genesis user.

Do not recycle UUIDs when accounts are deleted on your platform. A recycled identifier could attribute historical comments to the wrong person.

Historical comments

Linking applies to the external identity, not just future events. Existing imported comments that reference that identity can display the linked Genesis profile. Their original integration attribution and source timestamp remain intact.

Source timestamps

Send timestamp when preserving the original publication time matters. It must be a valid ISO 8601 value with an explicit timezone, such as 2026-07-28T10:30:00+09:00.

Genesis stores both the source time and import time. If no source time is supplied, receipt time is used. Values more than five minutes in the future are rejected.

Username changes

The username is display metadata, not the identity key. Continue sending the stable UUID if a member renames themselves. Later deliveries may update the external identity's display name without creating a second identity.