Skip to main content
POST
Ingest an alias event

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Headers

x-orbit-cdp-signature
string
required

HMAC-SHA256 of the raw request body, keyed by the tenant ingest secret.

x-orbit-cdp-timestamp
string
required

Unix-epoch seconds the payload was signed; rejected outside the replay window.

x-orbit-cdp-nonce
string
required

Unique per-request nonce used to reject replays.

Path Parameters

ingest_id
string
required

Public, tenant-bound ingest identifier from your CDP source config.

Body

application/json
userId
string
required
previousId
string
required
timestamp
string<date-time>
messageId
string

Response

200 - application/json

Alias accepted. merge_action reports the identity-resolution outcome (merged, rebound or noop); the target/source contact ids are populated when a merge occurred.

data
object
meta
object