Quick Start

Getting Started

Get up and running with GoodSender in 5 minutes. Authenticate your domain, create an API key, and send your first email.

Overview

GoodSender is a free email sending service created to eliminate unwanted emails. All emails sent through GoodSender are explicitly approved by recipients, ensuring a spam-free experience. Whether you're sending newsletters, transactional emails, or marketing campaigns, GoodSender provides a reliable and user-friendly platform to connect with your audience without the worry of being marked as spam.

Why GoodSender?

Zero cost

• Nothing extra
• No spam complaints
• Send to pre-approved recipients

Powered by Laneful

• Simple setup
• Reliable email infrastrucure
• Bult by veterans of the email industry

Prerequisites

Important: You cannot send emails without first authenticating your domain. This is required for all email providers and ensures your emails are trusted by recipients.

Domain Authentication (Required)

Before sending any emails, you must authenticate the domain you'll be sending from. This involves adding DNS records that prove you own the domain.

Set Up Domain Authentication

5-Minute Quick Start

All emails sent through GoodSender must be approved by recipients, ensuring a spam-free experience.
Follow these steps to send your first email with GoodSender:

Authenticate Your Domain

Add DNS records to verify you own the domain you'll send emails from.

Create an API Key

Generate an API key to authenticate your requests to the GoodSender API.

Set up redirect and webhook URLs

Use workspace settings to configure the redirect and webhook URLs for handling verification requests.
GoodSender will `POST` a JSON array where each item includes the domain, its verification status, and the approved or rejected email addresses for that domain.

POST https://yourapp.com/webhooks/goodsender
Content-Type: application/json

{
  "example.com": {
    "approved": [
      "alice@example.com",
      "ops@example.com"
    ],
    "rejected": [
      "bob@example.com"
    ]
  },
  "otherdomain.com": {
    "approved": [
      "charlie@example.com"
    ],
    "rejected": [
      "blocked@otherdomain.com"
    ]
  }
}

Verify Your Email Addresses

Ensure all recipient email addresses are verified and opted in to receive communications.

curl -X POST https://api.goodsender.com/v1/emails/verify \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example.com",
    "emails": ["recipient@example.com"]
  }'

Send Your First Email

Use our API or SMTP to send your first email through your lane.

curl -X POST https://api.goodsender.com/v1/emails/send \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": [
      {
        "from": { "email": "sender@example.com", "name": "Example Sender" },
        "to": [{ "email": "recipient@example.com" }],
        "subject": "Hello from GoodSender",
        "text_content": "Your first email is on the way."
      }
    ]
  }'

API Reference →