Skip to main content
The Suppressions API protects your domain’s sending reputation and delivers on Google and Yahoo compliance requirements. When an email bounces or receives a spam complaint via Feedback Loop (FBL), Gork automatically adds the recipient address to the suppression list, preventing future sends to that destination.

Google & Yahoo Deliverability Ceilings

Gork strictly enforces deliverability guardrails across all outbound traffic:
  • Spam Complaint Ceiling: < 0.30% (per Google Email Sender Guidelines)
  • Hard Bounce Ceiling: < 5.0%
  • Senders that exceed these thresholds trigger an automatic protective circuit breaker, pausing outbound sending (403 Forbidden with code sending_not_approved) until reviewed in the console.

1. List Suppressions

Retrieve suppressed email addresses for your organization.

Endpoint

GET /v1/suppressions

Query Parameters

string
Filter by suppression reason: hard_bounce, complaint, unsubscribe, or manual.
number
default:"50"
Maximum number of records to return.

Response Example

200 OK

2. Add Suppression

Manually add an email address to the suppression list to immediately block future outgoing messages.

Endpoint

POST /v1/suppressions

Request Body

string
required
The recipient email address to suppress.
string
default:"manual"
Reason for suppression: manual, unsubscribe, hard_bounce, or complaint.

Request Example

cURL
Response 201 Created

3. Remove Suppression

Remove an address from the suppression list, allowing agents to send to this recipient again.

Endpoint

DELETE /v1/suppressions/{id}

Path Parameters

string
required
The unique ID of the suppression record (sup_...).

Response Example

200 OK