Delete Contact

Delete a contact by ID or email address. All associated data (properties, segment memberships, topic subscriptions) will be removed.

DELETE/contacts/{contact_id_or_email}

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

Requires an API key with contacts:write permission.

Path Parameters

contact_id_or_emailstringrequired

The contact ID (UUID) or email address.

Response Fields

objectstring

Always "contact".

idstring

The contact ID.

contactstring

The deleted contact ID (same value as id).

deletedboolean

Always true.

curl -X DELETE '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.remove({
  id: 'e169aa45-1ecf-4183-9955-b1499d5701d3',
});

Response

{
  "object": "contact",
  "id": "e169aa45-1ecf-4183-9955-b1499d5701d3",
  "contact": "e169aa45-1ecf-4183-9955-b1499d5701d3",
  "deleted": true
}