---
title: "Mailproxy create"
url: "https://help.internetx.com/en/api/core-mailproxy-create/"
lang: "en"
section: "API reference — API reference (XML/JSON)"
breadcrumb: "API documentation (JSON/XML) > Tasks > MailProxy tasks"
updated: "2023-09-18"
---

# Mailproxy create

## Function

The _MailproxyCreate_ task creates a new MailProxy entry.

## Description

Route: POST /mailProxy  

```
{
   "domain": "example.com",
   "target": "example2.com",
   "admin": "customer@example.com",
   "protection": "CUSTOM",
   "greylisting": "ENABLED",
   "virus": "ACCEPT",
   "bannedFiles": "ACCEPT",
   "spam": {
      "modifySubject": true,
      "tagHeader": "-999",
      "spam": "6.5",
      "kill": "999"
   },
   "whitelist": {
      "emails": [
         "person1@good-example.com",
         "someone-else@company123.net"
      ]
   },
   "blacklist": {
      "emails": [
         "bad-person@example.de",
         "someone-bad@company987.net"
      ]
   },
   "excludelist": {
      "emails": [
         "admin@somethingsomething73456.net",
         "hostmaster@somethingsomething73456.net"
      ]
   }
}

```

```
{
   "stid": "20190919-stid",
   "status": {
      "code": "S0511",
      "text": "aMailProxy successfully registered.",
      "type": "SUCCESS"
   },
   "object": {
      "type": "MailProxy",
      "value": "somethingsomething73456.net"
   }
}
```

Task Code: 0511

Uses [MailProxy](/en/api/core-mailproxy-object/) object

```
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>104</context>
	</auth>
	<owner>
		<user>subuser</user>
		<context>104</context>
	</owner>
	<task>
		<code>0511</code>
		<mail_proxy>
			<domain>example1695.com</domain>
		</mail_proxy>
		<reply_to>customer@example.com</reply_to>
		<ctid>customer-transaction-id</ctid>
	</task>
</request>
```

```
<response>
<result>
	<data/>
	<status>
		<code>S0511</code>
		<text>MailProxy successfully registered.</text>
		<type>success</type>
		<object>
			<type>mailproxy</type>
			<value>example1695.com</value>
		</object>
	</status>
</result>
<stid>20150427-stid</stid>
</response>
```