Dedicated IPsSet an IP as the account default

Set an IP as the account default

Marks this IP as the default. Sends that omit ip_id will route through the default IP. Each account has exactly one default at a time — calling this endpoint clears the previous default automatically.

curl -X POST "https://api.supasend.io/v1/ips/example_string/default" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "id": "example_string",
  "ip_address": "203.0.113.45",
  "region": "EU",
  "business_name": "Acme Mailer",
  "status": "provisioning",
  "is_default": true,
  "monthly_price_cents": 2000
}
POST
/v1/ips/{id}/default
POST
Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-API-Key)
X-API-Keystring
Required

API key in the format sk_live_<64 hex characters>

API key in the format sk_live_<64 hex characters>
Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-API-Keystring
Required

API Key for authentication. API key in the format sk_live_\<64 hex characters\>

Path Parameters

Responses

idstring
ip_addressstring
regionstring
Allowed values:EUUS
business_namestring
statusstring

active — usable for sends. suspended — monthly charge could not be covered; top up the wallet to restore it. Other states are transitional while the SupaSend team provisions or releases the IP.

Allowed values:provisioningactivereleasingreleasedsuspended
is_defaultboolean

When true, this IP is used for any send that omits ip_id. Each account has exactly one default IP at a time; the first IP assigned to your account is auto-promoted to default.

monthly_price_centsinteger