Dedicated IPs
Request, manage, and warm up dedicated sending IP addresses
Dedicated IPs
Dedicated IPs give you exclusive control over a sending IP's reputation. Unlike shared pools, your IP is never affected by other senders. Max plan includes 1 dedicated IP; Enterprise plans include 5.
Auth scope: ips
Plan Availability
| Plan | Dedicated IPs |
|---|---|
| Free | 0 |
| Pro | 0 |
| Max | 1 |
| Enterprise | 5 |
Additional IPs can be requested for Enterprise accounts — contact sales.
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/v1/dedicated-ips | List assigned IPs |
POST | /api/v1/dedicated-ips | Request a dedicated IP |
GET | /api/v1/dedicated-ips/:id | IP details and warm-up status |
PATCH | /api/v1/dedicated-ips/:id | Update IP settings |
DELETE | /api/v1/dedicated-ips/:id | Release an IP |
GET /api/v1/dedicated-ips
List all dedicated IPs assigned to the account.
curl https://mail.misar.io/api/v1/dedicated-ips \
-H "Authorization: Bearer msk_YOUR_API_KEY"Response
{
"success": true,
"ips": [
{
"id": "ip_abc123",
"address": "198.51.100.42",
"rdns": "mail.yourdomain.com",
"warmup_status": "warming",
"warmup_percent": 62,
"pool": "marketing",
"created_at": "2026-03-15T10:00:00Z"
}
]
}POST /api/v1/dedicated-ips
Request a new dedicated IP for the account. Provisioning takes up to 24 hours. A warm-up schedule begins automatically.
curl -X POST https://mail.misar.io/api/v1/dedicated-ips \
-H "Authorization: Bearer msk_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"pool": "marketing",
"rdns": "mail.yourdomain.com"
}'Request Fields
| Field | Type | Required | Notes |
|---|---|---|---|
pool | string | — | IP pool assignment: transactional, marketing (default: marketing) |
rdns | string | — | Reverse DNS (PTR record) hostname for the IP |
Response
{
"success": true,
"ip": {
"id": "ip_abc123",
"address": "198.51.100.42",
"warmup_status": "not_started",
"pool": "marketing",
"provisioned_at": null
},
"message": "IP provisioning in progress. Expected within 24 hours."
}GET /api/v1/dedicated-ips/:id
Get detailed status and warm-up schedule for a specific IP.
curl https://mail.misar.io/api/v1/dedicated-ips/ip_abc123 \
-H "Authorization: Bearer msk_YOUR_API_KEY"Response
{
"success": true,
"ip": {
"id": "ip_abc123",
"address": "198.51.100.42",
"rdns": "mail.yourdomain.com",
"pool": "marketing",
"warmup_status": "warming",
"warmup_percent": 62,
"daily_limit": 8000,
"reputation_score":84,
"warmup_schedule": [
{ "day": 1, "limit": 200, "sent": 200, "done": true },
{ "day": 7, "limit": 1000, "sent": 1000, "done": true },
{ "day": 14, "limit": 4000, "sent": 3800, "done": false },
{ "day": 21, "limit": 10000, "sent": 0, "done": false },
{ "day": 28, "limit": 25000, "sent": 0, "done": false }
],
"created_at": "2026-03-15T10:00:00Z"
}
}warmup_status values
| Status | Meaning |
|---|---|
not_started | IP provisioned but warm-up not yet begun |
warming | Active warm-up in progress |
warmed | Warm-up complete — full daily limit available |
suspended | Temporary suspension due to complaint spike |
PATCH /api/v1/dedicated-ips/:id
Update settings for an assigned IP.
curl -X PATCH https://mail.misar.io/api/v1/dedicated-ips/ip_abc123 \
-H "Authorization: Bearer msk_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "pool": "transactional", "rdns": "tx.yourdomain.com" }'Updatable Fields
| Field | Notes |
|---|---|
pool | Reassign to a different IP pool |
rdns | Update PTR record hostname |
DELETE /api/v1/dedicated-ips/:id
Release a dedicated IP. Sends will fall back to the shared IP pool for the assigned pool type.
curl -X DELETE https://mail.misar.io/api/v1/dedicated-ips/ip_abc123 \
-H "Authorization: Bearer msk_YOUR_API_KEY"Response
{ "success": true }Releasing a warmed IP permanently discards its reputation history. This action cannot be undone.