Official libraries & CLI

npm install dairo

import { Dairo } from "dairo";

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

const result = await dairo.messages.send({
  inboxId: "inbox_123",
  to: "ada@example.com",
  subject: "Hello from Dairo",
  text: "Hi Ada",
});
console.log(result.id, result.status, result.channel);

pip install dairo

from dairo import Dairo

dairo = Dairo()  # reads DAIRO_API_KEY, or pass api_key="dairo_live_…"

message = dairo.messages.send(
    inbox_id="inbox_123",
    to="customer@example.com",
    subject="Welcome",
    text="Thanks for trying Dairo.",
)
print(message.id, message.status)

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

package main

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

    dairo "github.com/dairo-app/dairo-go"
)

func main() {
    client := dairo.NewClient(os.Getenv("DAIRO_API_KEY"))
    out, err := client.Send(context.Background(), dairo.SendMessageRequest{
        InboxID: "inbox_123",
        To:      []string{"person@example.com"},
        Subject: "Welcome",
        Text:    "Hello from Dairo",
    })
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(out.ID, out.Status)
}

gem install dairo --pre

require "dairo"

client = Dairo::Client.new(api_key: ENV.fetch("DAIRO_API_KEY"))

response = client.send({
  inboxId: "inbox_123",
  to: ["person@example.com"],
  subject: "Hello from Dairo",
  text: "Plain text body",
  html: "<p>HTML body</p>",
})

puts response.fetch("status") # "sent"

composer require dairo/dairo

<?php

use Dairo\DairoClient;

$dairo = new DairoClient(getenv('DAIRO_API_KEY'));

$outbound = $dairo->send([
    'inboxId' => 'inbox_123',
    'to' => ['person@example.com'],
    'subject' => 'Welcome',
    'text' => 'Hello from Dairo',
    'html' => '<p>Hello from Dairo</p>',
]);

echo $outbound['status']; // sent

<dependency>
  <groupId>app.dairo</groupId>
  <artifactId>dairo-java</artifactId>
  <version>0.1.2</version>
</dependency>

import app.dairo.DairoClient;

DairoClient client = new DairoClient(System.getenv("DAIRO_API_KEY"));

String response = client.send(
    "{\"inboxId\":\"inbox_123\",\"to\":[\"person@example.com\"]," +
    "\"subject\":\"Hello\",\"text\":\"Plain body\",\"html\":\"<p>HTML body</p>\"}",
    "idem-123"); // optional idempotency key

[dependencies]
dairo = { git = "https://github.com/dairo-app/dairo-rust" }

use dairo::{Client, RequestOptions, SendMessageRequest};

#[tokio::main]
async fn main() -> Result<(), dairo::DairoError> {
    let client = Client::new("dairo_live_xxx")?;
    let sent = client.send(
        &SendMessageRequest {
            inbox_id: "inbox_123".to_string(),
            to: vec!["person@example.com".to_string()],
            subject: Some("Welcome".to_string()),
            text: Some("Hello from Dairo".to_string()),
            // channel defaults to the inbox's channel ("email"); set "a2a" to target Dairo inboxes.
            ..Default::default()
        },
        RequestOptions::default(),
    ).await?;
    println!("message {} is {}", sent.id, sent.status);
    Ok(())
}

dotnet add package Dairo

using Dairo;

var client = new DairoClient(new DairoOptions { ApiKey = "dairo_live_xxx" });

var sent = await client.SendAsync(new SendMessageRequest(
    InboxId: "inbox_123",
    To: ["person@example.com"],
    Subject: "Hello",
    Text: "Plain text body",
    Html: "<p>HTML body</p>"));

Console.WriteLine($"{sent.Id} {sent.Status}");

def deps do
  [
    {:dairo, "~> 0.1"}
  ]
end

client = Dairo.Client.new(System.fetch_env!("DAIRO_API_KEY"))

{:ok, response} =
  Dairo.Client.send(client, %{
    inboxId: "inbox_123",
    to: ["person@example.com"],
    subject: "Hello",
    text: "Plain-text body",
    html: "<p>HTML body</p>"
  })

response["status"]