# Inbound domain forwarding

If you have access to your DNS records, Postmark includes a simple way for you to configure your MX records to point to our mail servers, so that all email sent to a domain or sub-domain is processed by Postmark. If you do not have access to your DNS records, we support [email being forwarded by 3rd party mail services](https://support.postmarkapp.com/article/785-configuring-a-custom-email-address-forward-with-gmail).

### 1. Set an MX Record

Choose a domain that you would like to listen on for incoming email to be processed by Postmark. In your DNS configuration, create an MX record that points to **inbound.postmarkapp.com** and give it a value of 10.

If you plan on just using your root domain for your inbound domain forwarding, then you'd add @ as the Name value in the MX record in your DNS configuration:

| **Type** | **Name** | **Priority** | **Value** | **TTL** |
|---|---|---|---|---|
| MX | @ | 10 | inbound.postmarkapp.com | 1/2 Hour |

![](https://postmark-app.transforms.svdcdn.com/production/customers/InboundMXRecord.png?w=1277&h=94&q=85&auto=format&fit=crop&dm=1777232930&s=ec59c6f8f77741bd01aeeb8b7ff3bc25)

However, we typically recommend that you use a separate subdomain for your inbound domain forwarding. For example, **example.yourdomain.com**. You would add the subdomain value to the Name field in your MX record:

| **Type** | **Name** | **Priority** | **Value** | **TTL** |
|---|---|---|---|---|
| MX | example | 10 | inbound.postmarkapp.com | 1 Hour |

![](https://postmark-app.transforms.svdcdn.com/production/customers/ExampleMX.png?w=2530&h=158&q=85&auto=format&fit=crop&dm=1777232928&s=63c194f50c2d7ce32c62d898bfe67435)

You may also use a “wildcard” inbound domain such as ***.yourdomain.com** which will cause all messages addressed to any subdomain of **yourdomain.com** to be routed to your inbound endpoint. For example, if you register ***.yourdomain.com** with Postmark and your DNS host, you may then use an inbound address such as **user@client1.yourdomain.com** and it will be routed to your inbound endpoint. In the MX record, you'd list ***** as the Name value:

| **Type** | **Name** | **Priority** | **Value** | **TTL** |
|---|---|---|---|---|
| MX | * | 10 | inbound.postmarkapp.com | 1 Hour |

![](https://postmark-app.transforms.svdcdn.com/production/customers/MX2.png?w=4000&h=276&q=85&auto=format&fit=crop&dm=1777232933&s=429f0d40b1fe5308c7c9cb1274b4e21b)

### 2. Set the domain

Inbound domains are unique across Postmark and are Stream-specific. You can configure the Inbound Domain on the Stream settings page.

![](https://postmark-app.transforms.svdcdn.com/production/customers/pm_inbound_forwarding.jpg?w=1638&h=292&q=85&auto=format&fit=crop&dm=1777232972&s=a13195050cfe629740cf1d69bfa7a95f)

Alternatively, you can use the [Server API](/api/server#edit-the-server) to set the Inbound Domain on your server.

### Example request with curl

```bash
curl "https://api.postmarkapp.com/servers/:serverid" \
  -X PUT \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Postmark-Account-Token: account token" \
  -d "{InboundDomain: 'inbound.yourdomain.com'}"
```

### Example JSON response

```js
{
  "Name": "Production Testing",
  "Color": "blue",
  "SmtpApiActivated": false,
  "RawEmailEnabled": false,
  "InboundHookUrl": "http://hooks.example.com/inbound",
  "BounceHookUrl": "http://hooks.example.com/bounce",
  "OpenHookUrl": "http://hooks.example.com/open",
  "PostFirstOpenOnly": false,
  "InboundDomain": ""
}
```

### 3. Enable SMTP

Enable SMTP on the server’s settings page.

![](https://postmark-app.transforms.svdcdn.com/production/customers/pm-smtp-inbound-settings.jpg?w=671&h=163&q=85&auto=format&fit=crop&dm=1777232972&s=abeab9e9ae74ae138660d23915a0fc2f)

```

```

### 4. Receive emails

You can now receive emails sent to any address on the inbound forwarding domain and they will be processed using Postmark.

```

```

[← Configure an inbound server](/user-guide/inbound/configure-an-inbound-server) [Parse an email →](/user-guide/inbound/parse-an-email)
