Authenticate a domain
POST https://api.sendgrid.com/v3/whitelabel/domains
This endpoint allows you to authenticate a domain.
If you are authenticating a domain for a subuser, you have two options:
1. Use the username
parameter. This allows you to authenticate a domain on behalf of your subuser. This means the subuser is able to see and modify the created whitelabel.
2. Use the Association workflow (see Associate Domain section). This allows you to authenticate a domain created by the parent to a subuser. This means the subuser will default to the assigned domain, but will not be able to see or modify that whitelabel. However, if the subuser authenticates their own domain it will overwrite the assigned domain.
An authenticated domain allows you to remove the “via” or “sent on behalf of” message that your recipients see when they read your emails. It replaces sendgrid.net with your personal sending domain. If you choose to use Automated Security, SendGrid provids 3 CNAME records. If you turn Automated Security off, you will be given 2 TXT records and 1 MX record. You need to enter these records into your DNS provider.
For more information on whitelabeling, please see our User Guide
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string | ||
Content-Type | string |