cURL
Verstuur je eerste e-mail met alleen curl: exporteer een API-sleutel, verstuur een bericht met POST en haal het met GET op om de bezorging te volgen. Dit is de kale HTTP-flow; alles wat de SDK's doen, begint hier.
1. Exporteer je API-sleutel
Maak een sleutel aan in het dashboard onder Platform tools > API keys (Verstuur je eerste e-mail legt het stap voor stap uit) en exporteer hem daarna:
export BIRD_API_KEY="bk_us1_..."Het regiovoorvoegsel bepaalt je API-host: bk_us1_-sleutels roepen https://us1.platform.bird.com aan en bk_eu1_-sleutels roepen https://eu1.platform.bird.com aan. De verzendvoorbeelden gebruiken us1; wijzig de host als je sleutel bij een andere regio hoort.
2. Verstuur een e-mail
Doe een POST naar /v1/email/messages en verstuur vanaf ons gedeelde onboardingdomein naar het delivered@messagebird.dev-sandboxadres. Je hebt geen domeinverificatie of echte mailbox nodig. Kies het tabblad cURL voor deze quickstart.
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 \
--category transactional \
--cc manager@acme.com \
--from 'Acme Support <noreply@acme.com>' \
--header X-Campaign=spring-2026 \
--html '<h1>Hi there 👋</h1>' \
--metadata '{"user_id":"usr_12345"}' \
--reply-to support@acme.com \
--subject 'Welcome aboard' \
--tag category=welcome \
--text 'Hi there' \
--to 'Jane Doe <delivered@messagebird.dev>' \
--track-clicks=falsecurl -X POST https://us1.platform.bird.com/v1/email/messages \
-H "Authorization: Bearer $BIRD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "onboarding@messagebird.dev",
"to": ["delivered@messagebird.dev"],
"subject": "Hello from Bird",
"html": "<p>My first Bird email.</p>"
}'De API antwoordt met 202: Bird heeft de e-mail geaccepteerd en bezorgt hem asynchroon. Met de *_count-velden volg je de ontvangers door de bezorgstatussen. In het eerste antwoord is één ontvanger geaccepteerd en is er nog geen bezorgd:
{
"id": "em_01ky7ma8y2es1s2akzk53tmjn0",
"status": "accepted",
"category": "marketing",
"from": { "email": "onboarding@messagebird.dev" },
"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"
}Bij kale HTTP is er geen SDK die een idempotentiesleutel voor je genereert. Wil je beschermd zijn bij opnieuw proberen, geef dan bij de eerste poging een sleutel mee en gebruik die opnieuw bij elke nieuwe poging. Zie Idempotentie voor een voorbeeld en de limieten voor herhaalde verzoeken.
3. Volg de bezorging
Haal het bericht op met GET via zijn em_-ID en zie de status van accepted via processed naar delivered gaan. Selecteer opnieuw het tabblad cURL:
const msg = await bird.email.get("em_abc123");
msg.status; // "accepted" | "processed" | "delivered" | "bounced" | …
msg.delivered_count;
msg.bounced_count;
console.log(msg.subject, msg.subject_recipient_id);message = client.email.get("em_abc123")
print(message.id, message.status, message.delivered_count)
print(message.subject, message.subject_recipient_id)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.Get(context.Background(), "em_abc123")
if err != nil {
log.Fatal(err)
}
fmt.Println(*msg.Status, *msg.DeliveredCount)
fmt.Println(msg.Subject)
if msg.SubjectRecipientId != nil {
fmt.Println(*msg.SubjectRecipientId)
}
}$message = $bird->email->get('em_01krdgeqcxet5s7t44vh8rt9mg');
echo $message->getStatus();
echo $message->getSubject(), ' ', $message->getSubjectRecipientId();bird email get <message-id>curl https://us1.platform.bird.com/v1/email/messages/em_01ky7ma8y2es1s2akzk53tmjn0 \
-H "Authorization: Bearer $BIRD_API_KEY"Omdat de ontvanger het delivered@messagebird.dev-sandboxadres is, is aflevering gegarandeerd: het bericht doorloopt de echte pipeline van Bird, maar komt nooit in een echte mailbox terecht.
Volgende stappen
- Referentie voor de e-mail-API: het volledige schema van verzoek en antwoord.
- Authenticatie: sleutels, scopes en de
Authorization-header. - Je eerste e-mail versturen: dezelfde flow met het dashboard en de SDK's.
- Verzenddomeinen: verifieer je eigen domein om in productie te versturen.
Gerelateerde bronnen
Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.