Send your first email

npm install dairo

pip install dairo

go get github.com/dairo-app/dairo-go

curl -fsSL https://dairo.app/install.sh | sh

import { Dairo } from "dairo";

const dairo = new Dairo({ apiKey: process.env.DAIRO_API_KEY! });

const domain = await dairo.domains.create({ domain: "yourapp.com" });
for (const record of domain.records) {
  console.log(record.type, record.host, "→", record.value);
}

from dairo import Dairo

dairo = Dairo()  # reads DAIRO_API_KEY

domain = dairo.domains.create(domain="yourapp.com")
for record in domain.records:
    print(record.type, record.host, "→", record.value)

dairo domain add yourapp.com

curl -X POST https://api.dairo.app/v1/domains \
  -H "Authorization: Bearer $DAIRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"yourapp.com"}'

dairo domain recheck yourapp.com

curl -X POST https://api.dairo.app/v1/domains/yourapp.com/verify \
  -H "Authorization: Bearer $DAIRO_API_KEY"

const inbox = await dairo.inboxes.create({
  username: "hello",
  domain: "yourapp.com",
});
console.log(inbox.id, inbox.address); // <id> hello@yourapp.com

inbox = dairo.inboxes.create(username="hello", domain="yourapp.com")
print(inbox.id, inbox.address)  # <id> hello@yourapp.com

dairo inbox create hello --domain yourapp.com

curl -X POST https://api.dairo.app/v1/inboxes \
  -H "Authorization: Bearer $DAIRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"hello","domain":"yourapp.com"}'

const result = await dairo.messages.send(
  {
    inboxId: inbox.id,
    to: "you@example.com",
    subject: "Hello from Dairo",
    text: "Dairo is sending real email now.",
    html: "<p>Dairo is sending <strong>real email</strong> now.</p>",
  },
  { idempotencyKey: "quickstart-first-send" },
);

console.log(result.id, result.status, result.channel); // <id> sent email

result = dairo.messages.send(
    inbox_id=inbox.id,
    to="you@example.com",
    subject="Hello from Dairo",
    text="Dairo is sending real email now.",
    html="<p>Dairo is sending <strong>real email</strong> now.</p>",
    idempotency_key="quickstart-first-send",
)

print(result.id, result.status)  # <id> sent

dairo send \
  --inbox-id inbox_123 \
  --to you@example.com \
  --subject "Hello from Dairo" \
  --text "Dairo is sending real email now."

curl -X POST https://api.dairo.app/v1/messages \
  -H "Authorization: Bearer $DAIRO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quickstart-first-send" \
  -d '{
    "inboxId": "inbox_123",
    "to": "you@example.com",
    "subject": "Hello from Dairo",
    "text": "Dairo is sending real email now."
  }'

const { events } = await dairo.messages.listEvents(result.id);
for (const event of events) {
  console.log(event.type, event.recipient, event.occurredAt);
}

for event in dairo.messages.list_events(result.id):
    print(event.type, event.recipient, event.occurred_at)

dairo outbound get <id>      # status and latest event
dairo outbound events <id>   # the full delivery timeline

const page = await dairo.messages.list({ inboxId: inbox.id });
for (const m of page.messages) {
  console.log(m.direction, m.from.address, m.subject);
}

page = dairo.messages.list(inbox_id=inbox.id)
for m in page.messages:
    print(m.direction, m.from_.address, m.subject)

dairo messages list --inbox-id inbox_123