Quickstart

curl https://api.blujay.io/v1/chats \
  -H "Authorization: Bearer $BLUJAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quickstart-0001" \
  -d '{
    "from": "+15555550100",
    "to": ["+15555550123"],
    "message": {
      "parts": [{ "type": "text", "text": "Hi! This is my first message from the Blujay API." }]
    }
  }'

const response = await fetch("https://api.blujay.io/v1/chats", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BLUJAY_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "quickstart-0001",
  },
  body: JSON.stringify({
    from: "+15555550100",
    to: ["+15555550123"],
    message: {
      parts: [{ type: "text", text: "Hi! This is my first message from the Blujay API." }],
    },
  }),
});

const body = await response.json();
if (body.status === "error") {
  throw new Error(`${body.error.code}: ${body.error.message} (trace ${body.trace_id})`);
}
console.log(response.status, body.data.chat_id, body.data.message.id);

import os
import requests

response = requests.post(
    "https://api.blujay.io/v1/chats",
    headers={
        "Authorization": f"Bearer {os.environ['BLUJAY_API_KEY']}",
        "Idempotency-Key": "quickstart-0001",
    },
    json={
        "from": "+15555550100",
        "to": ["+15555550123"],
        "message": {
            "parts": [{"type": "text", "text": "Hi! This is my first message from the Blujay API."}]
        },
    },
    timeout=30,
)

body = response.json()
if body["status"] == "error":
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']} (trace {body['trace_id']})")
print(response.status_code, body["data"]["chat_id"], body["data"]["message"]["id"])

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

func main() {
	payload := map[string]any{
		"from": "+15555550100",
		"to":   []string{"+15555550123"},
		"message": map[string]any{
			"parts": []map[string]string{
				{"type": "text", "text": "Hi! This is my first message from the Blujay API."},
			},
		},
	}
	body, _ := json.Marshal(payload)

	req, _ := http.NewRequest("POST", "https://api.blujay.io/v1/chats", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("BLUJAY_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Idempotency-Key", "quickstart-0001")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var result struct {
		Status string `json:"status"`
		Error  struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
		TraceID string `json:"trace_id"`
		Data    struct {
			ChatID  string `json:"chat_id"`
			Message struct {
				ID string `json:"id"`
			} `json:"message"`
		} `json:"data"`
	}
	json.NewDecoder(resp.Body).Decode(&result)
	if result.Status == "error" {
		panic(fmt.Sprintf("%s: %s (trace %s)", result.Error.Code, result.Error.Message, result.TraceID))
	}
	fmt.Println(resp.StatusCode, result.Data.ChatID, result.Data.Message.ID)
}