Skip to main content
GET
/
contacts
/
{identifier}
Find Contact
curl --request GET \
  --url https://api.brew.new/v1/contacts/{identifier} \
  --header 'Authorization: Bearer <token>'
{
  "id": "cont_2Jk9mN8pQ7rX4vL1",
  "email": "[email protected]",
  "firstName": "Sarah",
  "lastName": "Wilson",
  "userId": "user_98765",
  "source": "Website signup",
  "subscribed": true,
  "subscriptionGroups": {
    "sg_newsletter": true,
    "sg_product_updates": true,
    "sg_promotions": false
  },
  "companyName": "Tech Innovations Inc",
  "jobTitle": "Senior Developer",
  "planType": "Enterprise"
}

Authorizations

​
Authorization
string
header
required

Include your Brew API key as a Bearer token in the Authorization header. Example: Authorization: Bearer bw_api_your_key_here

Path Parameters

​
identifier
string
required

Either the contact's email address or their userId. When using an email address, you must URI-encode it (replace @ with %40). - Email: user%40example.com (for [email protected]) - User ID: user_12345

Response

Contact found and returned with all current data

Complete contact object with all properties

​
id
string
required

Unique contact identifier

Example:

"cont_2Jk9mN8pQ7rX4vL1"

​
email
string<email>
required

Contact's email address

Example:

"[email protected]"

​
source
string
required

How the contact was added to your audience

Example:

"API"

​
subscribed
boolean
required

Whether the contact is subscribed to marketing emails

Example:

true

​
subscriptionGroups
object
required

Contact's subscription group memberships

Example:
{
  "sg_newsletter": true,
  "sg_product_updates": false
}
​
firstName
string | null

Contact's first name (null if not provided)

Example:

"Jane"

​
lastName
string | null

Contact's last name (null if not provided)

Example:

"Smith"

​
userId
string | null

External user ID if provided (null if not set)

Example:

"user_12345"