Contacts & Bounce API

What is Contacts & Bounce API?

Keep your sender reputation pristine by automatically writing hard bounces (`550 User Unknown`) and unsubscribes to global suppression tables.

The Contacts API supports bulk JSON ingestion up to 10,000 contacts per request with duplicate deduplication.

Any contact present in the suppression table will be automatically skipped during campaign dispatches.

Key Features

Automated Bounce Scrubbing

Hard bounce email addresses are auto-written to global suppressions to prevent repeated delivery failures.

Bulk JSON Ingestion

Upload up to 10,000 contacts per API request with automatic email deduplication.

How It Works

1. Post unsubscribed or hard-bounced email addresses to `https://inbox.staurax.com/api/v1/suppressions`.

2. The API validates the address and records it in your account's global suppression table.

3. Future campaign batch jobs query the suppression table and skip flagged contacts automatically.

Code Example & API Usage

                                curl -X POST https://inbox.staurax.com/api/v1/suppressions \
  -H "Authorization: Bearer stx_live_9f8a3c2b1e4d5" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "reason": "550 5.1.1 Hard Bounce"
  }'                            

Protect Your Domain Reputation

Maintain 99%+ deliverability by keeping your suppression lists synchronized.

View Suppression Dashboard