Notiblast
HomeApp
HomeApp
  1. Lists
  • API Key & Izin
  • Email
    • 1. Alur Email
    • 2. Domain & DNS
    • 3. Kirim Email
    • 4. Status Email
    • Messages
      • List Messages
      • Export Messages (CSV)
      • Detail Message
    • Send Email
      POST
  • Whatsapp
    • 1. Alur WhatsApp
    • 2. Hubungkan Nomor
    • 3. Setelah Nomor Terhubung
    • 4. Template Pesan
    • 5. Syarat Template Authentication
    • 6. Verifikasi Bisnis Meta
    • 7. Kirim & Status Pesan
    • Messages
      • List Messages
      • Detail Message
      • Export Messages (CSV)
    • Send WhatsApp
      POST
  • Reports
    • Overview (Dasbor)
    • Email Monitoring
    • WhatsApp Monitoring
    • Push Notification Monitoring
    • Deliverability Summary
  • Push
    • 1. Alur Push Notification
    • 2. Aplikasi Push & Firebase
    • 3. Pasang SDK
    • 4. List Penerima
    • 5. Kirim & Hasil Push
    • Devices
      • Register Device
      • Release Device
    • Messages
      • List Push Messages
      • Get Push Message
    • Lists
      • List Push Lists
        GET
      • List Push List Members
        GET
      • Add Push List Members
        POST
      • Remove Push List Members
        DELETE
    • Send Push Notification
      POST
  • Api Logs
    • List API Logs
    • Detail API Log
  • Webhooks
    • Webhook Events (Notiblast → Endpoint Anda)
  1. Lists

Add Push List Members

Developing
POST
https://primaryapi.notiblast.com/v1/push-lists/{push_list_id}/members
Menambah anggota ke List/Segmen.
external_id yang sudah menjadi anggota dilewati diam-diam, bukan menggagalkan permintaan: menempel ulang daftar yang sama adalah hal yang wajar. skipped_count melaporkan berapa yang dilewati, diturunkan dari selisih -- bukan query kedua.

Autentikasi#

API key ber-full_access (Authorization: Bearer ntbl_<prefix>_<secret>) atau sesi dasbor (Authorization: Bearer {{TOKEN}} + X-Company).
Key sending_access ditolak 403. List milik company, bukan per aplikasi: kalau sending_access boleh mengubahnya, key yang sudah dipersempit ke satu push_app tetap bisa mengubah audiens semua aplikasi.
API mengatur siapa yang ada di dalam list; dasbor menentukan list apa yang ada. Membuat, mengganti nama, dan menghapus list tetap khusus dasbor (modul Internal).

Rate limit#

600 per menit. Panggilan dengan API key berkunci per IP (key bukan user), jadi satu server backend berbagi satu bucket. Body menerima sampai 10.000 external_id per panggilan; untuk sinkronisasi massal, batching tetap cara paling efisien.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Success
application/json
Bodyapplication/json

🟠403Akses ditolak
🟠404Tidak ada / milik company lain
🟠401Tidak terautentikasi
🟠402Langganan tidak aktif
🟠400Permintaan tidak valid
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://primaryapi.notiblast.com/v1/push-lists/507f1f77bcf86cd799439033/members' \
--header 'Content-Type: application/json' \
--data '{
    "external_ids": [
        "usr_88213",
        "usr_90001",
        "usr_90002"
    ]
}'
Response Response Example
201 - Example 1
{
    "request_id": "0f9c2a41-8d3e-4c77-9a2b-5f1e6d0c8a73",
    "message": "Push list members added",
    "data": {
        "added_count": 2,
        "skipped_count": 1,
        "member_count": 4220
    }
}
Modified at 2026-10-21 07:54:50
Previous
List Push List Members
Next
Remove Push List Members
Built with