IP Whitelist

The IP Whitelist API lets you view and manage whitelisted IP addresses to which api key and SMTP credential usage is restricted.

List Mailgun account IP whitelist entries

get/v2/ip_whitelist

List Mailgun account IP whitelist entries

SecuritybasicAuth

Responses

200

A 200 response

Response Schema: application/json

required

Array of objects

Array

ip_address required	string
description required	string

403

A 403 response

Request samples

Response samples

200
403

application/json

{"addresses": [{"description": "OnPrem Server",
"ip_address": "10.11.11.111"
}
]
}

Update individual Mailgun account IP whitelist entry's description

put/v2/ip_whitelist

Update individual Mailgun account IP whitelist entry's description

SecuritybasicAuth

Request

Request Body schema: multipart/form-data
required

address required	string Address to be updated in the whitelist
description	string Description of the address to be updated in the whitelist, defaults to empty string

Responses

200

A 200 response

Response Schema: application/json

required

Array of objects

Array

ip_address required	string
description required	string

400

A 400 response

Request samples

Response samples

200
400

application/json

{"addresses": [{"description": "OnPrem Server 1",
"ip_address": "10.11.11.111"
}
]
}

Add Mailgun account IP whitelist entry

post/v2/ip_whitelist

Add Mailgun account IP whitelist entry

SecuritybasicAuth

Request

Request Body schema: multipart/form-data
required

address required	string Address to be added to the whitelist
description	string Description of the address to be added to the whitelist, defaults to empty string

Responses

200

A 200 response

Response Schema: application/json

required

Array of objects

Array

ip_address required	string
description required	string

400

A 400 response

Request samples

Response samples

200
400

application/json

{"addresses": [{"description": "OnPrem Server",
"ip_address": "10.11.11.111"
}
]
}

Delete Mailgun account IP whitelist entry

delete/v2/ip_whitelist

Delete Mailgun account IP whitelist entry

SecuritybasicAuth

Request

query Parameters

address

required

string

Address to be deleted from whitelist

Responses

200

A 200 response

Response Schema: application/json

required

Array of objects

Array

ip_address required	string
description required	string

400

A 400 response

Request samples

Response samples

200
400

application/json

{"addresses": [ ]
}

IP Whitelist

List Mailgun account IP whitelist entries

Response Schema: application/json

Update individual Mailgun account IP whitelist entry's description

Request Body schema: multipart/form-datarequired

Response Schema: application/json

Add Mailgun account IP whitelist entry

Request Body schema: multipart/form-datarequired

Response Schema: application/json

Delete Mailgun account IP whitelist entry

query Parameters

Response Schema: application/json

Request Body schema: multipart/form-data
required

Request Body schema: multipart/form-data
required