---
title: "MailProxy object"
url: "https://help.internetx.com/en/api/core-mailproxy-object/"
lang: "en"
section: "API reference — API reference (XML/JSON)"
breadcrumb: "API documentation (JSON/XML) > Objects"
updated: "2023-09-25"
---

# MailProxy object

## Description

The _MailProxy_ object represents a MailProxy.

## Structure

| Keyword JSON | KeywordXML | Occurs | Type | Format | Description |
| --- | --- | --- | --- | --- | --- |
| admin | admin | 0 - 1 | string | email | Email address of the administrator to whom notifications are sent. |
| bannedFiles | banned\_files | 0 - 1 | object | [MailProxyPolicy](/en/api/core-mailproxy-policy-object/) | Defines whether files should be checked and how banned files should be avoided. |
| blacklist | blacklist | 0 - 1 | object | [MailList](/en/api/core-mail-list-object/) | Specification of email addresses whose mails are always to be marked as spam. |
| created | created | 0 - 1 | string | date-time | Date on which the MailProxy was created. |
| domain | domain | 1 | string | domain | Domains for which the MailProxy is used. |
| excludelist | exclude | 0 - 1 | object | [MailList](/en/api/core-mail-list-object/) | Definition of administrative addresses that should never be ignored by spam filters. An example of this is the "Hostmaster" addresses, e.g. [hostmaster@example.com](mailto:hostmaster@example.com). |
| greylisting | greylisting | 0 - 1 | object | [GreylistingPolicy](/en/api/core-greylisting-policy-object/) | If greylisting is activated, the first email from an unknown sender is rejected at first. Mails from this sender will only be accepted after a further delayed delivery attempt. |
| header | header | 0 - 1 | object | [MailProxyPolicy](/en/api/core-mailproxy-policy-object/) | Defines whether headers are to be checked and how banned headers are to be handled. |
| idn | idn | 0 - 1 | string |  | IDN version of the domain name |
| owner | owner |  | object | [BasicUser](/en/api/core-basic-user-object/) | Object owner |
| protection | protection | 0 - 1 | enum | [Mailproxy\_Protection](/en/api/core-mailproxy-protection-protection-constants/) | Security settings for handling infected mails. |
| spam | spam | 0 - 1 | object | [SpamPolicy](/en/api/core-spam-policy-object/) | Policy für spam |
| target | target | 1 | string | hostname | Mail server to which the MailProxy should forward the emails. Note that the MX record of your mail server must be removed from the zone. |
| updated | updated | 0 - 1 | string | date-time | Date on which the MailProxy was last updated. |
| updater | updater | 0 - 1 | object | [BasicUser](/en/api/core-basic-user-object/) | User who performed the last update. |
| virus | virus | 0 - 1 | object | [MailProxyPolicy](/en/api/core-mailproxy-policy-object/) | Defines whether to check for viruses and how to deal with detected viruses. |
| whitelist | whitelist | 0 - 1 | object | [MailList](/en/api/core-mail-list-object/) | Define email addresses whose mails should be trusted and never marked as spam. |