Build it in your own project.

Send to the email sandbox

Set up the SDK and API key in your own server environment. This example uses Bird's sanctioned test recipient.

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"

A brief for your coding agent

# Build a Bird integration

Use the official Bird SDK and the current documentation at https://bird.com/docs.
Start with the sanctioned email destination delivered@messagebird.dev.
Keep API keys on the server and read BIRD_API_KEY from the environment.
Use the smallest permissions required for the task.

Build an order confirmation that includes the customer's name and order reference.
Record request acceptance separately from delivery events.
Verify incoming webhook signatures using the original request body.
Deduplicate events by their stable identifier and process state transitions by event time.
Respect marketing opt-outs. Test hard bounces, invalid signatures, duplicate events, and temporary failures.

Before production: configure a verified sender, confirm recipient consent and channel rules,
and review the code and test results with the team operating the integration.