Request a dedicated sending IP
POST/v1/dedicated_ips
Assigns an available address and charges the first month — $19, Blueprint 9.3 — at once. The address starts a 14-day warm-up: a fresh IP has no reputation, and inbox providers treat none as bad, so volume ramps from a few hundred a day and doubles. Billed monthly on the calendar day it was taken; nothing is refunded for the rest of a month on release, because a month is what was bought. Live keys only. Requires domains:manage.
Example
curl -X POST https://api.woyra.io/v1/dedicated_ips \
-H "Authorization: Bearer $WOYRA_KEY"Response
201 The assigned address.
| Field | Type | Description |
|---|---|---|
| object | string | One of dedicated_ip. |
| id | string | |
| address | string | |
| pool | string | The provider-side pool the address belongs to. |
| status | string | One of available, warming, active, past_due, retired. |
| assigned_at | timestamp | |
| warming_until | timestamp | |
| warming | object | |
| warming.day | integer | |
| warming.allowance_today | integer | |
| warming.sent_today | integer | |
| monthly_micros | integer | |
| created_at | timestamp |
Errors
| Status | Codes |
|---|---|
| 402 | insufficient_funds, spend_cap_exceeded, email_limit_reached |
| 503 | route_unavailable |
Also in Email
- GET /v1/dedicated_ips — The account's dedicated sending IP
- DELETE /v1/dedicated_ips/{id} — Release a dedicated IP