Secwyn
PricingDashboard
Decision API

Pre-Send Decision API

Add Secwyn pre-send decisions to your workflow. All endpoints require a Bearer token.

API access is available on Growth and above

Authentication

Include your API key in every request:

curl -X POST https://www.secwyn.com/api/v1/email/check \
  -H "Authorization: Bearer fsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"email":"test@example.com"}'

Get your API key from the Dashboard.

Endpoints

POST/api/v1/email/check

Assess email syntax, domain signals, and available mailbox evidence.

Request
{
  "email": "test@mailinator.com"
}
Response
{
  "success": true,
  "email": "test@mailinator.com",
  "valid": true,
  "risk_score": 70,
  "audit_queue": "suppress",
  "primary_reason": "Disposable mailbox",
  "recommended_action": "Suppress"
}
POST/api/v1/ip/check

Analyze IP address for VPN, proxy, or private network signals.

Request
{
  "ip": "8.8.8.8"
}
Response
{
  "success": true,
  "ip": "8.8.8.8",
  "is_private": false,
  "is_localhost": false,
  "risk_score": 0
}
POST/api/v1/risk/check

Evaluate available email and IP signals with a recommended action.

Request
{
  "email": "spam@mailinator.com",
  "ip": "1.1.1.1"
}
Response
{
  "success": true,
  "risk_score": 70,
  "audit_queue": "suppress",
  "primary_reason": "Disposable mailbox",
  "recommended_action": "Suppress",
  "email": "spam@mailinator.com",
  "ip": "1.1.1.1"
}

Pre-send List Audit

POST/api/v1/pre-send/check

Run a pre-send list check before contacts enter your sender workflow.

Request (legacy pre-send endpoint)
{
  "emails": ["lead1@company.com", "spam@temp.com", "..."],
  "campaign_id": "spring-outreach-2026"
}
Response
{
  "success": true,
  "summary": { "total": 1000, "allowed": 820, "blocked": 180 },
  "campaign_risk": "LOW",
  "results": [{ "email": "...", "audit_queue": "send" }]
}
Integration tip: call this endpoint before sending. Keep Suppress contacts out of the send queue and resolve Review contacts with operator context.

Google Sheets

The spreadsheet install guide now lives on its own page so non-developers can jump straight into setup.

Open Google Sheets Guide

Error Codes

401 Missing or invalid API key
429 Monthly limit exceeded
400 Invalid request body

Ready to integrate?

Create a free account now, then upgrade to Growth when you need API access.

Create Free Account