Can I share one reference_id across multiple users?

Sharing a single reference_id across multiple end users is not supported.

Sharing a single reference_id across multiple end users is not supported. reference_id is meant to be your unique internal identifier for one end user.

Re-auth matching uses reference_id plus provider to find which connection belongs to a reconnecting user. When two users share a reference_id, that matching is ambiguous, so auth_success and user_reauth webhooks can fail to dispatch inconsistently.

Give every end user their own distinct reference_id.