Get Contact by Email

Get a contact by their email address.

CCarolina Josephik

Resend Audiences allow you to group and control your contacts in a simple and intuitive way.

From the beginning, we provided several ways to add new contacts to an audience:

  • via the API
  • from a CSV file
  • manually using the dashboard

Each contact has a unique ID, which you can use to get their contact information.

# Update by contact id
curl -X GET 'https://api.resend.com/audiences/78261eea-8f8b-4381-83c6-79fa7120f1cf/contacts/520784e2-887d-4c25-b53c-4ad46ad38100' \
    -H 'Authorization: Bearer re_123456789' \
    -H 'Content-Type: application/json'

Many of our users, however, found it frustrating to only be able to get contacts by their ID. Additionally, requiring an ID made some workflows much more complex or impossible—like checking if a contact was subscribed to an audience.

Today, we're introducing an additional way to get contacts: by their email address.

# Get by contact email
curl -X GET 'https://api.resend.com/audiences/78261eea-8f8b-4381-83c6-79fa7120f1cf/contacts/acme@example.com' \
    -H 'Authorization: Bearer re_123456789' \
    -H 'Content-Type: application/json'

All of our SDKs also support getting contacts by their email address.

import { Resend } from 'resend';


const resend = new Resend('re_123456789');


resend.contacts.get({
  email: 'steve.wozniak@gmail.com',
  audienceId: '78261eea-8f8b-4381-83c6-79fa7120f1cf',
});

We're excited to bring more consistency to our API and make it easier to work with contacts.