Transactional Email API

# 1. get a token from the Authenticate host
ACCESS_TOKEN=$(curl -s -X POST https://authenticate-dev.jirafix.net/v1/token \
  -H "Content-Type: application/json" \
  -d '{"username":"you@yourcompany.com","password":"'"$OLANZO_PASSWORD"'","privatetoken":"'"$OLANZO_PRIVATE_TOKEN"'"}' \
  | jq -r .access_token)

# 2. spend it here
curl -X GET "https://email-dev.jirafix.net/v1/email/lists" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

using var auth = new HttpClient { BaseAddress = new Uri("https://authenticate-dev.jirafix.net") };

var tokenResponse = await auth.PostAsJsonAsync("/v1/token", new
{
    username = "you@yourcompany.com",
    password = Environment.GetEnvironmentVariable("OLANZO_PASSWORD"),
    privatetoken = Environment.GetEnvironmentVariable("OLANZO_PRIVATE_TOKEN"),
});

// the property is access_token, not accessToken
var payload = await tokenResponse.Content.ReadFromJsonAsync<JsonElement>();
var token = payload.GetProperty("access_token").GetString();

using var api = new HttpClient { BaseAddress = new Uri("https://email-dev.jirafix.net") };
api.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", token);

var response = await api.SendAsync(
    new HttpRequestMessage(HttpMethod.Get, "/v1/email/lists"));

// 1. get a token from the Authenticate host
const tokenResponse = await fetch("https://authenticate-dev.jirafix.net/v1/token", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    username: "you@yourcompany.com",
    password: process.env.OLANZO_PASSWORD,
    privatetoken: process.env.OLANZO_PRIVATE_TOKEN,
  }),
});

// note the underscore — accessToken is undefined
const { access_token } = await tokenResponse.json();

// 2. spend it here
const response = await fetch("https://email-dev.jirafix.net/v1/email/lists", {
  method: "GET",
  headers: { Authorization: `Bearer ${access_token}` },
});

import os, requests

# 1. get a token from the Authenticate host
token_response = requests.post(
    "https://authenticate-dev.jirafix.net/v1/token",
    json={
        "username": "you@yourcompany.com",
        "password": os.environ["OLANZO_PASSWORD"],
        "privatetoken": os.environ["OLANZO_PRIVATE_TOKEN"],
    },
)

# note the underscore — "accessToken" raises KeyError
access_token = token_response.json()["access_token"]

# 2. spend it here
response = requests.get(
    "https://email-dev.jirafix.net/v1/email/lists",
    headers={"Authorization": f"Bearer {access_token}"},
)

200 OK

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

curl -X POST https://email-dev.jirafix.net/v1/email/send \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
        "SenderFrom": { "Email": "no-reply@yourcompany.com", "DisplayName": "Your Company" },
        "ReplyTo":    { "Email": "support@yourcompany.com" },
        "Subject": "Your order is confirmed",
        "EmailBody": "PHA+VGhhbmsgeW91IGZvciB5b3VyIG9yZGVyLjwvcD4=",
        "Recipient": {
          "To": "customer@example.com",
          "CcEmails": ["records@yourcompany.com"]
        }
      }'

curl -X POST https://email-dev.jirafix.net/v1/email/single \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
        "SenderFrom": { "Email": "no-reply@yourcompany.com" },
        "ReplyTo":    { "Email": "support@yourcompany.com" },
        "Subject": "Your invoice",
        "EmailBody": "PHA+SW52b2ljZSBhdHRhY2hlZC48L3A+",
        "Recipient": { "To": "customer@example.com" },
        "Attachments": [{
          "Content": "<base64-of-the-file>",
          "Filename": "invoice-1042.pdf",
          "Type": "application/pdf",
          "Disposition": "attachment"
        }]
      }'

curl -X POST https://email-dev.jirafix.net/v1/email/Single/ToMultipleRecipients \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
        "SenderFrom": { "Email": "no-reply@yourcompany.com" },
        "ReplyTo":    { "Email": "support@yourcompany.com" },
        "Subject": "Scheduled maintenance this Sunday",
        "EmailBody": "PHA+V2Ugd2lsbCBiZSBvZmZsaW5lIGJyaWVmbHkuPC9wPg==",
        "Recipients": { "To": ["a@example.com", "b@example.com"] }
      }'

curl -X POST https://email-dev.jirafix.net/v1/email/batch \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
        "SendingDetails": {
          "SenderFrom": { "Email": "no-reply@yourcompany.com" },
          "ReplyTo":    { "Email": "support@yourcompany.com" },
          "Subject": "Your statement is ready",
          "EmailBody": "PHA+SGVsbG8ge3tmaXJzdE5hbWV9fTwvcD4="
        },
        "Recipients": [
          { "To": "a@example.com" },
          { "To": "b@example.com" }
        ]
      }'

curl -X POST https://email-dev.jirafix.net/v1/email/predefinedemail \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
        "PredefinedTemplateId": "TEMAIL-822",
        "Recipients": [{ "To": "customer@example.com" }]
      }'

curl -X GET https://email-dev.jirafix.net/v1/email/9f1c7d2e-4b3a-4c1d-9e8f-2a7b6c5d4e3f/Status \
  -H "Authorization: Bearer <your-token>"

200 OK

{
  "QueueId": "9f1c7d2e-4b3a-4c1d-9e8f-2a7b6c5d4e3f",
  "Status": "Completed",
  "Message": "Sent",
  "Details": {
    "Total": 2,
    "Queued": 0,
    "Submitted": 2,
    "Delivered": 2,
    "Failed": 0
  }
}

curl -X GET https://email-dev.jirafix.net/v1/email/emailCampaigns \
  -H "Authorization: Bearer <your-token>"

curl -X GET https://email-dev.jirafix.net/v1/email/trigger-templates \
  -H "Authorization: Bearer <your-token>"

curl -X GET "https://email-dev.jirafix.net/v1/email/lists?excludeCount=true" \
  -H "Authorization: Bearer <your-token>"

curl -X GET https://email-dev.jirafix.net/v1/email/3fa85f64-5717-4562-b3fc-2c963f66afa6/contacts/count \
  -H "Authorization: Bearer <your-token>"