Unsendbox logo
Get started
← RETURN TO ROOT
Connected

Contact management

View contacts derived from your email threads and manage suppression state per address or domain.

Open contacts page

How contacts work

Contacts are derived from thread participants. No separate import or sync is needed.

Automatic derivation
Every unique email address seen in thread participants is surfaced as a contact. Thread count and last-active date are computed live.
Suppression integration
Each contact is checked against the suppression list. If a matching email or domain suppression exists, the contact shows a Blocked badge.
No manual creation
Contacts appear automatically as you send and receive email. There is no create-contact action — the list grows from real traffic.

Navigating the contacts page

Open `/dashboard/contacts` in the dashboard sidebar to access the contacts page.

  1. 01Use the search bar to filter contacts by email substring.
  2. 02Use the status dropdown to show All, Blocked, or Active contacts.
  3. 03The table displays email, domain, thread count, last active date, status badge, and row actions.
  4. 04Pagination controls appear when there are more than 20 contacts.

Block and unblock actions

Use row-level actions to manage suppression state directly from the contacts table.

Block Email
Creates an email-scoped suppression with reason "manual". Only this address is blocked; other addresses at the same domain remain active.
Block Domain
Creates a domain-scoped suppression with reason "manual". All addresses at the domain are blocked until the suppression is removed.
Unblock
Removes all matching suppressions for the contact. The contact returns to Active status and future sends are no longer suppressed.

Choosing the right scope

Pick email or domain scope based on the risk level and breadth of the problem.

Use email scope when
A single recipient is problematic (hard bounce, complaint) but the domain itself is healthy and other addresses should still receive mail.
Use domain scope when
The entire domain is untrusted, generates complaints, or is a known spam trap domain. This prevents sends to any address at that domain.
Review before unblocking
Before unblocking, check the deliverability dashboard for recent bounce or complaint events to avoid re-triggering the same issue.

API and UI reference

Where to find contact and suppression controls across the platform.

  1. 01Contacts API: `/api/v1/organizations/{organizationId}/contacts` supports list with search, pagination, and blocked filter.
  2. 02Suppressions API: `/api/v1/organizations/{organizationId}/suppressions` for create, list, get, and delete suppression entries.
  3. 03Contacts page: `/dashboard/contacts` for per-contact block/unblock with email or domain scope.
  4. 04Deliverability dashboard: `/dashboard/deliverability` for suppression list management by reason and email.