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://api.misar.io/mail/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://api.misar.io/mail/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://api.misar.io/mail/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://api.misar.io/mail/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://api.misar.io/mail/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.