Skip to main content
Implement POST /bilt/lookup-contact on your server. Bilt calls it with the request below.

Authorizations

​
Authorization
string
header
required

The credential you issue to Bilt for the endpoints you host. Validate it on every request, before you read the body, and keep it out of logs.

Body

application/json

A flat contact, unlike the nested contact on link account. Do not share a serializer between them. Agree normalization rules with Bilt during onboarding.

​
contactType
enum<string>
required

Return 400 for a type you do not support.

Available options:
email,
phone
​
contactValue
string
required

An RFC 5322 email address, or a phone number in E.164 format such as +14155552671.

Response

The lookup ran. Return exists: false for no match, not a 404, so a negative result is not confused with a routing error.

​
exists
boolean
required
​
partnerMemberId
string

Your member id when exists is true. Bilt sends it back on link account.