Get Contact

Retrieve a single contact by ID or email address.

GET/contacts/{contact_id_or_email}

Resend Compatibility: Partial -- Postflare supports lookup by email address in addition to ID, and returns properties.

Requires an API key with contacts:read permission.

Path Parameters

contact_id_or_emailstringrequired

The contact ID (UUID) or email address.

Response Fields

objectstring

Always "contact".

idstring

The contact ID.

emailstring

Contact email address.

first_namestring | null

Contact first name.

last_namestring | null

Contact last name.

unsubscribedboolean

Whether the contact is unsubscribed.

propertiesobject

Custom properties keyed by property name. Each value is an object with type (string or number) and a matching value.

created_atstring

ISO 8601 timestamp.

curl -X GET 'https://api.postflare.dev/contacts/e169aa45-1ecf-4183-9955-b1499d5701d3' \
  -H 'Authorization: Bearer sk_xxxxxxxxx'

// Set RESEND_BASE_URL=https://api.postflare.dev in the environment before
// the process starts. Without it the SDK sends to api.resend.com, silently.
import { Resend } from 'resend';

const resend = new Resend('sk_xxxxxxxxx');

const { data, error } = await resend.contacts.get({
  id: 'e169aa45-1ecf-4183-9955-b1499d5701d3',
});

Response

{
  "object": "contact",
  "id": "e169aa45-1ecf-4183-9955-b1499d5701d3",
  "email": "user@example.com",
  "first_name": "John",
  "last_name": "Doe",
  "unsubscribed": false,
  "properties": {
    "plan": { "type": "string", "value": "pro" }
  },
  "created_at": "2026-01-01T00:00:00.000Z"
}