Setup Checklist

Use this checklist to verify your Postscale setup is complete and ready for production sending. Each item links to the relevant documentation.

Account Setup

• Account created & email verified -- Sign up and verify your email address
• Plan selected -- Choose a plan from Settings > Billing in the dashboard
• API key created -- Generate a key from Settings > API Keys (Authentication guide)

Domain Configuration

• Domain added -- Add your sending domain in Domains > Add Domain (Domain Setup)
• SPF record configured -- Add include:_spf.postscale.io to your domain's SPF TXT record (details)
• DKIM record configured -- Add the DKIM TXT record from your domain's DNS settings (details)
• DMARC record configured -- Add a DMARC TXT record with your reporting address (details)
• Domain verified -- Click Verify Domain in the dashboard and confirm all records pass

Sending Readiness

• Domain warming started -- Warming begins automatically after DNS verification (Warming guide)
• Test email sent -- Send a test email via the API, SMTP, or the dashboard Send page
• Webhook endpoints configured (optional) -- Set up delivery/bounce/complaint webhooks (Webhooks guide)

Common Issues

Domain verification stuck on "Pending"

• DNS changes can take up to 48 hours to propagate (most resolve in minutes)
• Double-check record values for typos, especially the DKIM key
• Some DNS providers require TXT values without surrounding quotes
• Try clicking Verify Domain again after a few minutes

SPF record conflicts

If you already have an SPF record (e.g., for Google Workspace), add the Postscale include before the ~all:

v=spf1 include:_spf.google.com include:_spf.postscale.io ~all

Do not create a second TXT record with v=spf1 -- only one SPF record per domain is allowed.

Emails landing in spam during warming

This is normal in early warming phases. To minimize it:

• Send to engaged recipients first
• Avoid spam trigger words in subject lines
• Include a plain text version of your email (text_body)
• Ensure your from address matches your verified domain

See the IP & Domain Warming guide for more best practices.

DKIM value too long for DNS provider

Some DNS providers have a 255-character limit per TXT record string. If your DKIM key is truncated:

• Split it into multiple quoted strings (most providers handle this automatically)
• Contact your DNS provider's documentation for TXT record length limits