Skip to main content
POST
Stitch an anonymous session into a known contact

Body

application/json

The anonymous session id and the known identity to bind it to.

The anonymous session id and the known identity to bind it to.

anonymous_id
string

The SDK anonymous_id — the anonymous handle from your web SDK (e.g. anon_01h2x8…).

Required string length: 1 - 200
known_id
string

Your known identity for the person — your own stable external_id (e.g. crm-44882). Phone- or email-shaped values are refused; route those through identify.

Required string length: 1 - 200

Response

The stitch outcome. outcome is one of merged (both sides resolved as distinct contacts and the anonymous one was folded in), linked (only the anonymous side resolved; its contact was re-keyed), noop (already stitched / nothing to resolve — see reason), refused (phone/email-shaped known_id), or error (retry-safe — re-POST the same pair).

The stitch outcome. outcome is one of merged (both sides resolved as distinct contacts and the anonymous one was folded in), linked (only the anonymous side resolved; its contact was re-keyed), noop (already stitched / nothing to resolve — see reason), refused (phone/email-shaped known_id), or error (retry-safe — re-POST the same pair).

data
object
meta
object