E-mail verzenden

Een minimale verzending

const msg = await bird.email.send({
  from: { email: "onboarding@messagebird.dev", name: "Bird" },
  to: ["delivered@messagebird.dev"],
  subject: "Hello from Bird",
  html: "<p>My first Bird email.</p>",
});
console.log(msg.id, msg.status); // "em_…", "accepted"

msg = client.email.send(
    from_={"email": "onboarding@messagebird.dev", "name": "Bird"},
    to=["delivered@messagebird.dev"],
    subject="Hello from Bird",
    html="<p>My first Bird email.</p>",
)
print(msg.id, msg.status)

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	bird "github.com/messagebird/bird-sdk-go"
	"github.com/messagebird/bird-sdk-go/option"
)

func main() {
	client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_API_KEY")))
	if err != nil {
		log.Fatal(err)
	}
	msg, err := client.Email.Send(context.Background(), bird.EmailSendParams{
		From:    "onboarding@messagebird.dev",
		To:      []string{"delivered@messagebird.dev"},
		Subject: "Hello from Bird",
		HTML:    "<p>My first Bird email.</p>",
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(msg.Id, *msg.Status)
}

$message = $bird->email->send(
    from: 'Bird <onboarding@messagebird.dev>',
    to: ['delivered@messagebird.dev'],
    subject: 'Hello from Bird',
    html: '<p>My first Bird email.</p>',
);
echo $message->getId(), ' ', $message->getStatus();

bird email send \
  --from hello@yourdomain.com \
  --html '<p>It works.</p>' \
  --subject 'Hello from Bird' \
  --to delivered@messagebird.dev

curl -X POST https://us1.platform.bird.com/v1/email/messages \
  -H "Authorization: Bearer bk_us1_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": ["delivered@messagebird.dev"],
    "subject": "Hello from Bird",
    "html": "<p>It works.</p>"
  }'

Verzenden voordat je een domein verifieert

De payload opbouwen

Ontvangers

Inhoud

Reply-to en aangepaste headers

• Adresserings- en platformheaders. Stel de adressering van het bericht in via de specifieke velden (from, to, cc, bcc, reply_to, subject). Die namen, en de headers die wij voor je genereren (Content-Type, Content-Transfer-Encoding, DKIM-Signature, Received, Return-Path), kun je hier niet instellen.
• List-Unsubscribe en List-Unsubscribe-Post bij een marketing-verzending. Wij stellen zelf een conforme one-click-uitschrijfheader in. Bij een transactional-verzending laten we de jouwe precies zoals je ze instelt.
• Elke waarde met een carriage return of line feed.

Tracking

Categorie en IP-pool

Veldreferentie

Verzenden met een template

const msg = await bird.email.send({
  from: { email: "onboarding@messagebird.dev", name: "Bird" },
  to: ["delivered@messagebird.dev"],
  category: "transactional",
  template: {
    slug: "welcome-email",
    parameters: { first_name: "Jane" },
  },
});
console.log(msg.id, msg.status);

msg = client.email.send(
    from_={"email": "onboarding@messagebird.dev", "name": "Bird"},
    to=["delivered@messagebird.dev"],
    category="transactional",
    template="welcome-email",
    parameters={"first_name": "Jane"},
)
print(msg.id, msg.status)

msg, err := client.Email.Send(context.Background(), bird.EmailSendParams{
	From:       "onboarding@messagebird.dev",
	To:         []string{"delivered@messagebird.dev"},
	Category:   "transactional",
	Template:   "welcome-email",
	Parameters: map[string]any{"first_name": "Jane"},
})
if err != nil {
	log.Fatal(err)
}
fmt.Println(msg.Id, *msg.Status)

$message = $bird->email->send(
    from: 'Bird <onboarding@messagebird.dev>',
    to: ['delivered@messagebird.dev'],
    category: 'transactional',
    template: (new EmailMessageSendRequestTemplate())
        ->setSlug('welcome-email')
        ->setParameters(['first_name' => 'Jane']),
);
echo $message->getId(), ' ', $message->getStatus();

bird email send \
  --category transactional \
  --from hello@yourdomain.com \
  --parameters '{"first_name":"Jane"}' \
  --template welcome-email \
  --to delivered@messagebird.dev

curl -X POST https://us1.platform.bird.com/v1/email/messages \
  -H "Authorization: Bearer bk_us1_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": ["delivered@messagebird.dev"],
    "category": "transactional",
    "template": {
      "slug": "welcome-email",
      "parameters": { "first_name": "Jane" }
    }
  }'

• Inline of met template, nooit beide. template verzenden samen met subject, html of text wordt geweigerd met een 422. De API weigert ook variabelewaarden in het toplevel parameters-veld; bij een templateverzending horen ze in template.parameters.
• bird is de enige gereserveerde naam. Een placeholderpad dat begint met bird. verwijst naar onze eigen data, zoals de uitschrijflink of het contactrecord van de ontvanger, dus een template.parameters-sleutel mag niet bird heten. Elke andere sleutel definieer je zelf, en elke sleutel is één woord: {"order_number": "A-1043"} vult {{ order_number }}.
• Een template kan nu of later verzenden. Voeg scheduled_at toe om het verzenden in te plannen. We leggen de gepubliceerde versie, de geselecteerde taal en de parameterwaarden vast bij acceptatie. Als je het template verwijdert vóór het verzendtijdstip, wordt het bericht geweigerd met generation_failure.
• Een verzending gebruikt de gepubliceerde versie van het template. Concepten worden nooit verzonden. Een onbekend template wordt geweigerd met een 404, en een template zonder gepubliceerde versie met een 422.
• language kiest een van de talen van het template. Laat het weg om de standaardtaal van het template te verzenden. Vraag een taal aan die het template niet heeft, en de eigen on_missing_language-instelling bepaalt of de dichtstbijzijnde match wordt verzonden of de verzending wordt geweigerd. Een template dat language_source_required instelt, weigert een verzending die helemaal geen taal benoemt.
• De categorie van het template is een standaard, en de jouwe overschrijft die. Laat category weg en de verzending erft die van het template, dus een transactioneel template hoeft die niet bij elke aanroep herhaald.

Tags vs metadata

• tags zijn gestructureerde {name, value}-paren: maximaal 20 per verzending, naam maximaal 32 tekens, waarde maximaal 64, alleen ASCII-letters, cijfers, underscore en koppelteken, en namen uniek binnen de verzending. Tags zijn filterdimensies, dus je kunt de berichtenlijst filteren op tag en analytics en dashboardoverzichten uitsplitsen op tag. Gebruik ze voor labels met lage kardinaliteit zoals campaign, experiment_variant of source.
• metadata is een willekeurig JSON-object, maximaal 2 KB geserialiseerd. We slaan het op, retourneren het bij API-reads en sturen het mee bij elk webhook-event, dus het is geschikt voor context die je teruggestuurd wilt krijgen: interne ID's, foreign keys, gestructureerde payloads.

{
  "tags": [{ "name": "campaign", "value": "onboarding" }],
  "metadata": { "user_id": "usr_12345", "order_id": "ord_98765" }
}

Bijlagen

Wat een 202 betekent

{
  "id": "em_01ky7ma8y2es1s2akzk53tmjn0",
  "status": "accepted",
  "category": "marketing",
  "from": { "email": "hello@yourdomain.com" },
  "to": [{ "email": "delivered@messagebird.dev" }],
  "subject": "Hello from Bird",
  "accepted_count": 1,
  "processed_count": 0,
  "delivered_count": 0,
  "deferred_count": 0,
  "bounced_count": 0,
  "complained_count": 0,
  "rejected_count": 0,
  "open_count": 0,
  "click_count": 0,
  "track_opens": true,
  "track_clicks": true,
  "created_at": "2026-07-23T13:58:20.866Z"
}

• Reads retourneren status zonder de body. GET /v1/email/messages/{message_id} retourneert bericht- en ontvangerstatus, nooit de html- of text-body. Wanneer contentopslag is ingeschakeld voor de werkruimte, blijven opgeslagen body's tot 30 dagen beschikbaar via GET /v1/email/messages/{message_id}/content.
• Een read kan kort achterlopen op de verzending. Een 404 op de read-endpoints direct na een 202 betekent dat het bericht nog niet zichtbaar is; probeer het even later opnieuw.

Veilig opnieuw proberen

Batchverzending

Facturering

Volgende stappen

• E-mailtemplates: maak en publiceer de templates die je hier verstuurt
• Categorieën: hoe marketing en transactional het suppressiegedrag veranderen
• Suppressies: aan wie we niet bezorgen, en waarom
• Geplande verzending: bezorg op een toekomstig tijdstip met scheduled_at
• Testsandbox: sandbox-ontvangers en verzenden vóór domeinverificatie
• API-referentie: de volledige request- en responseschema's