Skip to main content
POST
Look up a contact by email

Look up by email

POST /contacts/lookup
The response is 200 OK with data: null when no active contact exists.

Upsert by email

POST /contacts/upsert
Upsert merges provided fields, validates declared audience properties, and returns the contact with created: true or created: false. Email is normalized per project and concurrent requests resolve to one active contact.

Authorizations

Authorization
string
header
required

Integration key for backend workloads, or a scoped personal key (sr_user_) for account discovery and supported project operations. MCP accepts only personal keys.

Headers

X-Sendrealm-Project-Id
string<uuid>

Explicit project context. Required for personal-key project resource calls; integration keys retain their configured default. MCP clients supply project_id in each tool call instead.

Body

application/json
email
string<email>
required

Response

Contact or null

status
integer
required

HTTP response status code

data
object | null
required