E-posta

E-posta gönder

Kullanıcının bağlı e-posta hesabından tek e-posta (yanıt dahil) gönderir; ileti yazışmaya ve projeye web'deki kurallarla bağlanır. Hesap bağlı değilse 400 send döner. Yalnız JSON gövde kabul edilir.

POST/api/v1/emails/send

Yetkilendirme

Authorizationheaderzorunlu

Bearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).

Kapsam: crm.write

Gövde application/json

tostringzorunlu

Alıcı(lar), virgülle.

subjectstringzorunlu

Konu.

bodystringzorunlu

Metin (düz yazı).

ccstringisteğe bağlı

Bilgi.

customer_id / contact_id / opp_idintegeristeğe bağlı

Bağlanacak kayıtlar.

in_reply_tostringisteğe bağlı

Yanıtlanan iletinin Message-ID'si (reply.in_reply_to).

Hatalar

HTTP	error	Anlamı
`400`	`invalid`	Eksik ya da geçersiz alan (`message` ayrıntıyı verir).
`400`	`send`	E-posta gönderilemedi (hesap bağlı değil, alıcı geçersiz…).

İstek

curl -X POST https://ornek.solk.app/api/v1/emails/send \
  -H "Authorization: Bearer $SOLK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": "x@ornek.com",
  "subject": "Deneme",
  "body": ""
}'

const res = await fetch("https://ornek.solk.app/api/v1/emails/send", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "to": "x@ornek.com",
    "subject": "Deneme",
    "body": ""
  }),
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/v1/emails/send",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    json={
        "to": "x@ornek.com",
        "subject": "Deneme",
        "body": ""
    },
)
print(r.json())

Yanıt

{
  "error": "invalid",
  "message": "E-posta metni boş.",
  "ok": false
}

Örnek yanıt örnek veriyle çalışan bir v22 kurulumundan alındı; listeler en çok iki öğeyle kısaltıldı.