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
POSThttps://g.sendcorex.com/v1/contacts

Cara 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. 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. 2

    Pilih scope

    Integrasi hanya-baca cukup membutuhkan contact:read. Sinkronisasi yang mengimpor dan memperbarui membutuhkan contact:create dan contact:update.

  3. 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. 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:read

    Membaca kontak, list, field, segmen, event, dan statistik.

  • contact:create

    Membuat list, field, dan segmen. Upsert juga membutuhkannya, untuk membuat kontak baru.

  • contact:update

    Memperbarui kontak, tag, status, field, dan keanggotaan list.

  • contact:delete

    Menghapus kontak, list, field, dan segmen.

i

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"
  }
}
status

Global. Kontak yang berhenti berlangganan, bounce, mengeluh, atau diblokir tidak dapat dikirimi di list mana pun.

lists

Keanggotaan dan langganan per list. Seseorang bisa keluar dari satu list dan tetap di list lainnya.

sendable

Berlangganan list dan berstatus subscribed. Inilah yang menjadi tujuan pengiriman kampanye.

stats

Pengiriman, 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 Contacts

Hormati tautan berhenti berlangganan

Berhentikan langganan dari satu list dengan Set List Subscription, atau dari semuanya dengan Set Status.

Set List Subscription

Temukan pelanggan yang aktif

Query berdasarkan list, tag, dan last_open_at, diurutkan menurut open_rate. Simpan sebagai segmen untuk dipakai ulang.

Query Contacts

Ekspor list

Telusuri List Members dengan sendable_only dan pilih hanya field yang Anda perlukan, 5.000 anggota per halaman.

List Members

Referensi lengkap

Semua yang ditandai CMD adalah perintah yang dikirim melalui POST /v1/contacts, hingga 20 per request.