Getting Started

Get up and running with GoodPostal in under 10 minutes. This guide walks you through creating your account, connecting an email sending service, and sending your first campaign.

Prerequisites

Before you begin, you will need an account with at least one email sending service. GoodPostal supports SendGrid, Mailgun, Amazon SES, Postmark, SMTP2GO, and Mailtrap.

Tip
If you do not have an email sending service account yet, we recommend starting with SendGrid or Postmark. Both are quick to set up, and Postmark offers a free developer tier for testing.
Note
Generic SMTP connections are available by request after one-time admin approval. Most users connect one of the six supported API-based services such as SendGrid, Mailgun, Postmark, Amazon SES, SMTP2GO, or Mailtrap.

Quick Start

  1. 1

    Create your GoodPostal account

    Visit the registration page and create your account. After verifying your email you land on the dashboard, where a welcome checklist tracks your setup steps and links you straight to each one.
  2. 2

    Connect your email sending service

    Navigate to Configure > Email Providers and add your service credentials. GoodPostal will verify the connection before saving.
  3. 3

    Add and verify a sender identity

    Go to Configure > Sender Identities and add the name and email address your campaigns will come from. Verify it with the one-click link we email you. Campaigns cannot be sent without a verified sender identity.
  4. 4

    Import your contacts

    Go to Contacts and import a CSV file, or add contacts manually. Organize them into groups for targeted sending.
  5. 5

    Create and send your first campaign

    Head to Campaigns > Create Campaign. Choose a template, write your content, select your recipients, and hit send.

Dashboard Setup Checklist

The dashboard displays a welcome checklist that tracks five setup steps and links straight to the matching settings page:

  • Connect an email sending service - Add your SendGrid, Mailgun, Amazon SES, Postmark, SMTP2GO, or Mailtrap credentials under Configure > Email Providers.
  • Add a sender identity - The name and email address that appears as the sender, verified via a one-click email link.
  • Import contacts - Upload a CSV or paste a list under Contacts.
  • Create a template - Build your first email under Templates > Create Template.
  • Send your first campaign - Combine the template, sender, and a contact group under Campaigns > Create Campaign.
Note
You can do the steps in any order; there is no enforced wizard. The checklist disappears for good once all five are done. If something needs your attention before then, for example an inactive sending service or an unverified sender, a setup warning banner takes the checklist's place until you resolve it.

Connecting an Email Sending Service

GoodPostal lets you connect your own sending service. You control your sending infrastructure, which means better deliverability and no per-contact pricing surprises.

Each sending service requires different credentials. Here is a quick summary:

Sending Service Credentials Overview
Provider: SendGrid
API Key: SG.xxxx...
  Full Access, or Restricted Access with Mail Send,
  Tracking, and Event Notification
Note
You never enter a webhook signing key. When you connect a service, GoodPostal sets up the webhook and its signing secret for you, then verifies every incoming event against it.
Warning
If your SendGrid key carries Mail Send permission only, GoodPostal cannot switch on SendGrid's hosted unsubscribe link for you, and you will need a custom tracking domain before you can send.

For detailed setup instructions, visit the sending service guides.

Your First Campaign

Once your sending service is connected, you have a verified sender identity, and you have at least one contact, you are ready to send your first campaign.

Campaign Wizard

The campaign creation wizard walks you through seven steps:

  1. Setup - Campaign name, campaign type, and an optional description
  2. Recipients - Select contact groups
  3. Content - Subject line, preview text, and your template or design
  4. Sender - Pick the verified sender identity this campaign comes from, which also determines the sending service used
  5. Schedule - Send now or pick a date and time, plus A/B settings if you are running a test
  6. Review - Check every setting and send a test email
  7. Send - Launch the campaign
Warning
Always send a test email to yourself before launching a campaign to your full list. Use the "Send Test" button on the review step.

Next Steps

Join our newsletter

Keep up with the latest from GoodPostal. No spam, just the good stuff.

We care about your data. Read our privacy policy.