Skip to content
Pidgely Docs

API reference · Native API (v1)

Add a suppression

POSThttps://api.pidgely.com/v1/suppressions
View as Markdown

Suppresses an address.

Authorization: Bearer pdg_…. An API key with the full scope.

Body parameters

JSON object.

Name Type Required Description
address string Yes Email address.

Request

cURL
curl -X POST 'https://api.pidgely.com/v1/suppressions' \
  -H "Authorization: Bearer $PIDGELY_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "address": "bounced@example.com"
}'

Response

201 Created with a JSON object.

Errors

Native routes return {"error": {"code", "message", "field", "request_id"}}. See Errors.

Status Code When
401 missing_api_key No Authorization: Bearer header.
403 invalid_api_key, insufficient_scope The key is invalid or lacks the scope.
404 not_found The resource does not exist in this account.
422 validation_error A field is missing or invalid; field names it.
429 rate_limited, daily_quota_exceeded Too many requests, or the quota is used up.