Kontak
Kelola audiens Anda dengan API
Jaga kontak Anda tetap sinkron dengan aplikasi. Impor ribuan sekaligus, beri tag, simpan field Anda sendiri, atur dalam list, dan temukan dengan tepat siapa yang harus dikirimi email, semuanya melalui satu endpoint.
- REST
- JSON
- Massal hingga 10.000 per request
- List, tag, dan field
- Segmen
https://g.sendcorex.com/v1/contactsCara kerja
Satu kontak per email
Kontak adalah milik akun Anda, bukan milik list. List, tag, custom field, dan status adalah atribut dari satu kontak itu, jadi tidak ada yang terduplikasi.
Satu endpoint untuk semuanya
Impor, beri tag, query, berhenti berlangganan, kelola list dan segmen: setiap aksi adalah perintah yang dikirim ke POST /v1/contacts. Hingga 20 perintah per request.
Dirancang untuk volume besar
Setiap aksi menerima hingga 500 email dan menjawab per email. Baris yang salah gagal sendiri; sisa batch tetap diproses.
Mulai
Empat langkah, dan hanya langkah pertama yang wajib sebelum request pertama Anda.
- 1
Buat API key
Di dashboard, buka Developers → API Keys dan buat key. Berikan scope kontak yang dibutuhkan aplikasi Anda.
Token webmail tidak berfungsi di sini. Kontak menggunakan API key dashboard yang sama dengan yang Anda pakai untuk mengirim email.
- 2
Pilih scope
Integrasi hanya-baca cukup membutuhkan contact:read. Sinkronisasi yang mengimpor dan memperbarui membutuhkan contact:create dan contact:update.
- 3
Tentukan field dan list Anda
Buat custom field yang ingin Anda simpan (paket, kota, ulang tahun…) dan list tujuan pengiriman. Anda juga bisa melakukannya dari dashboard.
- 4
Impor dan query
Kirim kontak Anda dengan Upsert Contacts, lalu temukan dengan Query Contacts.
Scope
Setiap perintah membutuhkan satu scope pada key. Jika ada yang tidak ada, hanya perintah itu yang gagal dengan MISSING_SCOPE; sisa request tetap berjalan.
contact:readMembaca kontak, list, field, segmen, event, dan statistik.
contact:createMembuat list, field, dan segmen. Upsert juga membutuhkannya, untuk membuat kontak baru.
contact:updateMemperbarui kontak, tag, status, field, dan keanggotaan list.
contact:deleteMenghapus kontak, list, field, dan segmen.
Daftar lengkap per perintah ada di Run Commands. Setiap halaman perintah juga menyebutkan scope yang dibutuhkan.
Kontak
Setiap pembacaan mengembalikan kontak dalam bentuk ini. Anda hanya menulis bagian yang Anda perlukan.
{
"email": "ana@acme.com",
"domain": "acme.com",
"first_name": "Ana",
"last_name": "Costa",
"phone": null,
"company": "Acme",
"locale": "pt-BR",
"timezone": "America/Sao_Paulo",
"source": "checkout",
"status": "subscribed",
"status_reason": null,
"status_at": "2026-10-13T06:05:08.323Z",
"created_at": "2026-10-13T06:05:08.323Z",
"updated_at": "2026-10-14T09:12:40.118Z",
"tags": [
"customer",
"vip"
],
"lists": {
"customers": {
"subscribed": true,
"sendable": true,
"added_at": "2026-10-13T06:05:08.323Z",
"unsubscribed_at": null
}
},
"fields": {
"plan": "pro",
"age": 31,
"city": "São Paulo"
},
"stats": {
"sent_count": 12,
"open_count": 7,
"click_count": 2,
"bounce_count": 0,
"complaint_count": 0,
"open_rate": 0.58,
"click_rate": 0.17,
"first_open_at": "2026-10-13T08:41:02.000Z",
"last_open_at": "2026-10-14T21:03:55.000Z",
"last_click_at": "2026-10-14T21:04:10.000Z",
"last_sent_at": "2026-10-14T20:58:31.000Z"
}
}statusGlobal. Kontak yang berhenti berlangganan, bounce, mengeluh, atau diblokir tidak dapat dikirimi di list mana pun.
listsKeanggotaan dan langganan per list. Seseorang bisa keluar dari satu list dan tetap di list lainnya.
sendableBerlangganan list dan berstatus subscribed. Inilah yang menjadi tujuan pengiriman kampanye.
statsPengiriman, open, dan klik dari tracking. Hanya-baca, dan Anda bisa memfilter serta mengurutkan berdasarkan data ini.
Request pertama Anda
Impor dua kontak lalu baca kembali, dalam satu request. Ganti SENDCOREX_API_KEY dengan API key Anda.
curl -X POST 'https://g.sendcorex.com/v1/contacts' \
-H "Authorization: $SENDCOREX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"commands": [
{ "command": "upsert_contacts", "args": {
"tags": ["imported"],
"contacts": [
{ "email": "ana@acme.com", "first_name": "Ana", "company": "Acme" },
{ "email": "bob@gmail.com", "first_name": "Bob" }
]
} },
{ "command": "query_contacts", "args": { "where": { "tags": { "has": "imported" } } } }
]
}' Anda mendapat satu hasil per perintah. Hasil pertama menunjukkan berapa kontak yang created; hasil kedua mengembalikan kontak tersebut. Jalankan lagi dan tidak ada yang ditulis: kedua baris kembali dengan changed: false. Request yang sama dalam 8 bahasa ada di Upsert Contacts.
Tugas umum
Sinkronkan pendaftaran dari aplikasi Anda
Lakukan upsert kontak dengan list_id di setiap pendaftaran. Mengirim ulang data yang sama tidak menulis apa pun, jadi aman juga dipanggil di setiap login.
Upsert ContactsHormati tautan berhenti berlangganan
Berhentikan langganan dari satu list dengan Set List Subscription, atau dari semuanya dengan Set Status.
Set List SubscriptionTemukan pelanggan yang aktif
Query berdasarkan list, tag, dan last_open_at, diurutkan menurut open_rate. Simpan sebagai segmen untuk dipakai ulang.
Query ContactsEkspor list
Telusuri List Members dengan sendable_only dan pilih hanya field yang Anda perlukan, 5.000 anggota per halaman.
List MembersReferensi lengkap
Semua yang ditandai CMD adalah perintah yang dikirim melalui POST /v1/contacts, hingga 20 per request.
Route
1Kontak
4Pencarian
2Tag, status, dan field
5List
9- CMDList ListsSemua list, beserta penghitung
- CMDGet ListSatu list dan penghitungnya
- CMDCreate ListId sendiri atau yang dibuat otomatis
- CMDUpdate ListNama, deskripsi, data custom
- CMDDelete ListKontak tetap disimpan
- CMDList MembersTelusuri list, hanya yang sendable
- CMDAdd To ListsBergabung ke satu atau beberapa list
- CMDRemove From ListsKeluar dari satu atau beberapa list
- CMDSet List SubscriptionBerhenti berlangganan dari satu list