400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
İçe aktarmayla aynı kural geçerlidir: izin "unknown" başlar, kişi bota kendisi yazmadan kampanya almaz. Telegram botunda external_id (sayısal sohbet kimliği) gerekir; WhatsApp botunda external_id yoksa phone kullanılır. Aynı kanal kimliği varsa 409 contact_exists döner. Yönetici yetkisi gerekir. Kapsam: contacts:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
Gövde alanları
Ad
Tür
Zorunlu
Açıklama
bot_id
uuid
evet
external_id
string
hayır
len ≤ 64
name
string
hayır
len ≤ 120
username
string
hayır
len ≤ 64
phone
string
hayır
len ≤ 32
tags
string[]
hayır
items ≤ 20
notes
string
hayır
len ≤ 4000
attributes
object
hayır
Özel alan anahtarı → değer (metin, sayı, YYYY-MM-DD tarih ya da seçenek)
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
409İşlem bu durumda yapılamıyor; kod nedeni söyler.contact_exists
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
tags tüm listeyi değiştirir; add_tags / remove_tags yalnızca ekler veya çıkarır. attributes yalnızca panelde tanımlı alanları kabul eder; null alanı temizler. Kapsam: write.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
Kişi, sohbetleri, mesajları ve kişiye bağlı diğer kişisel veriler geri alınamaz biçimde silinir. Denetim kaydında kanal kimliğinin yalnız özeti kalır. Yönetici yetkisi gerekir. Kapsam: contacts:write.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
Değişiklik izin defterine "api" kaynağıyla yazılır. tags verilirse kişinin etiket listesinin tamamını değiştirir; yalnız eklemek için updateContact add_tags kullanın. Kapsam: write.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
En fazla 2 MB ve 5.000 satır; ayraç noktalı virgül, virgül ya da sekme olabilir. Yeni kişilerin izni "unknown" başlar; var olanın izni yalnız "izin yok" yönünde değişir, dolu bilgileri korunur, etiketleri birleşir. Özel alan sütunları anahtar ya da adla eşleşir. errors en fazla 20 satır döner. Yönetici yetkisi gerekir. Kapsam: contacts:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
Her sayfa en fazla 1000 kişi taşır. Her satır CRLF ile biter; BOM ve başlık yalnız ilk sayfadadır, csv parçalarını sırayla uç uca ekleyince tek dosya olur. Formül enjeksiyonuna karşı = + - @ ile başlayan hücreler kaçışlanır. Her sayfa denetim kaydına yazılır. Yönetici yetkisi gerekir. Kapsam: contacts:read.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
tag_add, tag_remove, opt_out ya da delete; tek seferde en fazla 200 kişi. delete geri alınamaz ve yönetici ister. Üye yalnız erişebildiği botların kişilerini işler; diğer kimlikler sessizce dışarıda kalır, affected gerçekten değişen sayıdır. Kapsam: contacts:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
İki kaydın botuna da erişim gerekir; diğer kayıt erişilemiyorsa 404 döner. Bağlanamazsa 409 profile_link_failed, "profil" özelliği kapalıysa 409 feature_disabled döner. Kapsam: contacts:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
409İşlem bu durumda yapılamıyor; kod nedeni söyler.profile_link_failedfeature_disabled
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
409İşlem bu durumda yapılamıyor; kod nedeni söyler.not_linkedfeature_disabled
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
Organizasyondaki bütün kişilere uygulanır; eşleşme harf farkı gözetmez. Otomasyon adımları ve kampanya segmentleri otomatik değişmez. Yönetici yetkisi gerekir. Kapsam: contacts:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
Tek seferde en fazla 50 etiket. Organizasyondaki bütün kişilere uygulanır; otomasyon adımları ve kampanya segmentleri otomatik değişmez. Yönetici yetkisi gerekir. Kapsam: contacts:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
En fazla 30 alan (409 limit_reached); aynı anahtar 409 field_exists döner. key küçük harfle başlar, a–z, 0–9 ve _ içerir; ad, telefon gibi sistem anahtarları kullanılamaz. options yalnız secim türünde gerekir. AI yazma izni kapalı başlar. Yönetici yetkisi gerekir. Kapsam: contacts:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
409İşlem bu durumda yapılamıyor; kod nedeni söyler.limit_reachedfield_exists
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
Anahtar ve tür değişmez; options yalnız secim türünde geçerlidir. Listeden çıkan seçeneği taşıyan kişilerin değeri silinir (cleared_contacts). ai_writable, AI kayıt aracının bu alana yazmasına izin verir. Yönetici yetkisi gerekir. Kapsam: contacts:write.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.