Quickstart — Send Your First Email in 5 Minutes

npm install ark-email

gem install ark-email

go get github.com/ArkHQ-io/ark-go

import Ark from 'ark-email';

const client = new Ark({
  apiKey: process.env.ARK_API_KEY,
});

// Sandbox mode: use sandbox@arkhq.io, send to a team member
// Production: use your verified domain
const email = await client.emails.send({
  from: 'sandbox@arkhq.io',  // or 'hello@yourdomain.com' for production
  to: ['teammate@yourcompany.com'],
  subject: 'Hello from Ark!',
  html: '<h1>It works!</h1><p>You just sent your first email with Ark.</p>',
  text: 'It works! You just sent your first email with Ark.',
});

console.log(`Email ID: ${email.data.id}`);
console.log(`Status: ${email.data.status}`);
// Sandbox emails include: email.data.sandbox === true

require "ark_email"

client = ArkEmail::Client.new(api_key: ENV["ARK_API_KEY"])

# Sandbox mode: use sandbox@arkhq.io, send to a team member
# Production: use your verified domain
email = client.emails.send_(
  from: "sandbox@arkhq.io",  # or "hello@yourdomain.com" for production
  to: ["teammate@yourcompany.com"],
  subject: "Hello from Ark!",
  html: "<h1>It works!</h1><p>You just sent your first email with Ark.</p>",
  text: "It works! You just sent your first email with Ark."
)

puts "Email ID: #{email.data.id}"
puts "Status: #{email.data.status}"
# Sandbox emails include: email.data.sandbox == true

package main

import (
    "context"
    "fmt"
    "log"

    "github.com/ArkHQ-io/ark-go"
)

func main() {
    client := ark.NewClient() // Uses ARK_API_KEY env var

    // Sandbox mode: use sandbox@arkhq.io, send to a team member
    // Production: use your verified domain
    email, err := client.Emails.Send(context.Background(), ark.EmailSendParams{
        From:    "sandbox@arkhq.io",  // or "hello@yourdomain.com" for production
        To:      []string{"teammate@yourcompany.com"},
        Subject: "Hello from Ark!",
        HTML:    ark.String("<h1>It works!</h1><p>You just sent your first email with Ark.</p>"),
        Text:    ark.String("It works! You just sent your first email with Ark."),
    })
    if err != nil {
        log.Fatal(err)
    }

    fmt.Printf("Email ID: %s\n", email.Data.ID)
    fmt.Printf("Status: %s\n", email.Data.Status)
    // Sandbox emails include: email.Data.Sandbox == true
}

# Sandbox mode: use sandbox@arkhq.io, send to a team member
# Production: use your verified domain
curl -X POST https://api.arkhq.io/v1/emails \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "sandbox@arkhq.io",
    "to": ["teammate@yourcompany.com"],
    "subject": "Hello from Ark!",
    "html": "<h1>It works!</h1><p>You just sent your first email with Ark.</p>",
    "text": "It works! You just sent your first email with Ark."
  }'

const email = await client.emails.retrieve('msg_abc123xyz');

console.log(`Status: ${email.data.status}`);
console.log(`Timestamp: ${email.data.timestampIso}`);

email = client.emails.retrieve("msg_abc123xyz")

puts "Status: #{email.data.status}"
puts "Timestamp: #{email.data.timestamp_iso}"

email, err := client.Emails.Get(ctx, "msg_abc123xyz")
if err != nil {
    log.Fatal(err)
}

fmt.Printf("Status: %s\n", email.Data.Status)
fmt.Printf("Timestamp: %s\n", email.Data.TimestampIso)

curl https://api.arkhq.io/v1/emails/msg_abc123xyz \
  -H "Authorization: Bearer $ARK_API_KEY"