Getting started with Email

Your first email. A clear path to production.

Create an API key, test a message in the sandbox and verify your sending domain. Follow the quickstart, then bring the same sending workflow into your application.

Create your Bird account Follow the quickstart

Create your account, then follow the checklist for your API key, first send and domain setup.

Three steps to your first integration.

Test the integration first, then prepare your domain for real recipients.

01
Sign up for Bird.
Create your account and an API key for the region your application will use. Keep the key in your server environment and use it to authenticate your requests.
02
Send your first email.
Send a test email to a sandbox address with one API call. No domain to verify yet, the sandbox lets you try sending, webhooks, and suppression immediately. Read the quickstart →
03
Register your sending domain.
Add your domain and publish the DNS records Bird provides for DKIM signing and an aligned return path. Configure your DMARC policy, then check verification before sending to customers. Sending domains guide →

Put it into practice.

Continue with the documentation, guides and examples for this topic. Resources are in English.

Watch the guideGetting started with email Follow the learning pathBuild your first integration

Try the practice and get an implementation brief

Questions before your first send

How do I test without sending real email?

Send to documented sandbox addresses such as delivered@messagebird.dev, bounce@messagebird.dev or complaint@messagebird.dev. These exercise outcomes and webhooks through the normal pipeline. Keep a rehearsal audience limited to sandbox addresses; real addresses in the same send receive real mail.

Do I need my own verified domain immediately?

The onboarding domain supports a first send under its documented restrictions, and sandbox addresses support testing. Verify your own sending domain for regular sending. Check your workspace’s current limits rather than relying on a fixed plan allowance on this page.

Where should I start?

Use the first-email quickstart for an API integration, the SMTP guide for an existing SMTP application, Email marketing for campaigns, or the agent-mailbox quickstart for conversations. Each path links to the matching setup and documentation.

Choose your next step

Follow the first-send guideFind sending, receiving, campaigns and delivery controls.Connect an SMTP applicationKeep your SMTP integration and configure Bird as its relay.Find a guide or answerContinue with setup, troubleshooting and email concepts.

Your first email starts here.

Create your account, run a sandbox send and use the delivery events to check your integration before you send to customers.

Create your Bird account Follow the first-send guide