PlatformXeDocs
Get API Key

Sending Domains Overview

Authenticate custom sending domains for email delivery.

Custom sending domains let you send emails from your own domain (e.g., notifications@yourcompany.com) instead of a shared PlatformXe domain. This improves deliverability and brand trust.

Why use a custom domain

  • Better deliverability — emails from authenticated domains are less likely to land in spam
  • Brand consistency — recipients see your domain, not a third-party address
  • SPF/DKIM/DMARC compliance — meet enterprise email security requirements

How it works

  1. Register your domain via the API
  2. Configure DNS records — PlatformXe provides the SPF, DKIM, and DMARC records to add
  3. Verify — PlatformXe checks your DNS configuration and activates the domain

DNS records

After registering a domain, you will receive three types of DNS records to configure:

RecordTypePurpose
SPFTXTAuthorizes PlatformXe to send on your behalf
DKIMTXTCryptographic signature for message authenticity
DMARCTXTPolicy for handling authentication failures

DNS propagation can take up to 48 hours. If verification fails, wait and retry. Most domains verify within a few hours.

Quick example

// Register domain
const domain = await px.registerDomain({ domain: 'mail.yourcompany.com' });

// Get DNS records to configure
console.log(domain.data.dnsRecords);
// [{ type: 'TXT', name: '...', value: '...' }, ...]

// After configuring DNS, verify
const verified = await px.verifyDomain(domain.data.id);
console.log(verified.data.status); // "verified"

Next steps