If you plan to send from multiple domains, you should whitelabel at least one IP address per domain.

Whitelabeling IP addresses allows mailbox providers to verify the sender when they do a reverse DNS lookup upon receipt of the emails you send. This differs from domain whitelabeling in that, while you should have your IP addresses in your SPF records, actually whitelabeling the IP addresses does not require a change to SPF or DKIM records.

Only the parent account can whitelabel IP addresses. The parent account can then assign the IPs to the subusers accordingly.

An individual IP address can only be whitelabeled to a single domain, but a domain can have many IPs whitelabeled to it. This allows for you to use IP pooling for your email sending.

IP Whitelabel Settings

IP Address

The list of the IP addresses that are available on your account and you can choose to whitelabel a single IP address that currently does not have a whitelabel setup.

From here, you can see which subusers have access to send from each of these IPs as well as where the current reverse DNS (rDNS) points. Once whitelabeled and verified, the rDNS should point to your IP whitelabel subdomain.

Subdomain

This is the “prefix” of the domain that you are actually whitelabeling.

We suggest that you use the same subdomain as your domain whitelabel.

We will then prepend a second level subdomain similar to o1 incrementing the numeric value of this string as you add IP whitelabels to this subdomain.

Domain

The root domain for your subdomain. This is the domain that will receive the email reputation from the whitelabel. Your root domain should match your FROM email address. If you are sending from newsletter@example.com, then you should whitelabel example.com so the domains match.

Use New Domain

Allows you to add a new domain to your whitelabel options.

Default IP Whitelabel

There is no default IP whitelabel. If you only have a single IP address, this will be the only IP address that SendGrid sends from on your behalf.

Creating an IP Whitelabel

When you enter the information for your IP whitelabel and click “Save”, SendGrid will update its own internal DNS to prepare for your whitelabel settings. This process may take up to 60 seconds.

We will then give you the DNS A record entry that you need to enter at your host or registrar to match the new IP address.

Validate Your IP Whitelabel

Your IP whitelabel will not work properly until the A record is propagated and validated by SendGrid.

Once you have made the DNS changes, you need to validate your whitelabel:

  1. Return to IP whitelabels
  2. Click the whitelabel you just added (or the gear icon to the right of the whitelabel)
  3. Click “Validate”

If everything is set up properly and the DNS records have propagated, then SendGrid will verify your whitelabel.

Viewing Your IP Whitelabel

If you need to check the status of a whitelabel, you can see the “at a glance” information from the IP Whitelabel page. However, if you’re looking for more in-depth information or you need to find the DNS settings for your whitelabel then just click the gear icon next to the whitelabel and select “View.”

From this page you will be able to see all of the settings you entered when setting up your whitelabel, whether the whitelabel is valid, and all of the DNS settings you need for this whitelabel.

Adding An IP To Your Account

When you add an IP address to your SendGrid account then you will likely want to add a whitelabel for this IP address.

Deleting an IP Whitelabel

Deleting an IP whitelabel is permanent and can not be rolled back.

When you view your detailed whitelabel information, you will notice at the bottom of the page that you can delete this whitelabel. If you click the button and then confirm that you are sure you want to delete this whitelabel, then SendGrid will delete it.

Using the API

Manage your IP whitelabel via our v3 API