Skip to content

Server-Side Users

If your product already has a stable app-local user ID, Configure can create a developer-scoped profile without a user-present link flow.

ts
const configure = new Configure({
  apiKey: process.env.CONFIGURE_API_KEY,
  agent: "your-agent",
});

const profile = configure.profile({ externalId: "customer-123" });

await profile.remember("User prefers billing receipts by email.");
const read = await profile.read();

These unlinked profiles are scoped to your developer account. Other developers cannot resolve or read them.

externalId is your identifier, not a Configure-generated user ID. It is required for unlinked profiles because there is no linked Configure token to resolve the user. When the user later verifies through Configure Link, profile merge/linking is a later product flow; until then, treat the profile as app-local memory.

Personalization infrastructure for agents