Regions

Sendry can send through multiple Amazon SES regions. Set an organization-wide default region, override it per domain, and optionally pin data to a residency zone. Domains fall back to the org default, which falls back to the system default region.

---

List available SES regions

GET /v1/regions

Requires read_only scope. Use region_code when setting region preferences.

Response

{
  "data": [
    {
      "region_code": "us-east-1",
      "display_name": "Default (us-east-1)",
      "is_default": true
    },
    {
      "region_code": "eu-west-1",
      "display_name": "Europe (Ireland)",
      "is_default": false
    }
  ]
}

---

Get org default region settings

GET /v1/organizations/me/region

Requires read_only scope.

Response

{
  "default_region": "eu-west-1",
  "data_residency": "eu"
}

default_region is null when no org default is set. data_residency is one of none, eu, us, or ap.

---

Update org default region and data residency

PATCH /v1/organizations/me/region

Requires full_access scope.

Request body

Field	Type	Required	Description
default_region	string	No	Region code from GET /v1/regions. Pass null to clear the default.
data_residency	string	No	Residency constraint: none, eu, us, or ap.

{
  "default_region": "eu-west-1",
  "data_residency": "eu"
}

Response

{
  "default_region": "eu-west-1",
  "data_residency": "eu"
}

Returns 422 invalid_region if the region is not available. Returns 403 plan_limit_reached if data residency is requested on a plan that does not include it, or if the plan's non-default region limit is exceeded.

---

Set domain region preference

PATCH /v1/domains/:id/region

Requires full_access scope. Overrides the org default region for this domain.

Request body

Field	Type	Required	Description
region	string	No	Region code from GET /v1/regions. Pass null to clear the override.

{
  "region": "us-west-2"
}

Response

{
  "id": "dom_abc123",
  "name": "acme.com",
  "status": "verified",
  "region": "us-west-2",
  "created_at": "2025-03-12T09:00:00Z"
}

Returns 404 not_found if the domain does not belong to the organization, and 422 invalid_region if the region is not available.

---

Plan limits

Plan	Non-default regions	Data residency
Free	1	No
Pro	1	No
Business	3	Yes
Enterprise	Unlimited	Yes