Membuat page Notion lewat API terlihat sederhana: kirim request, isi property, selesai. Masalahnya, error kecil seperti nama property tidak cocok atau parent salah bisa membuat automation gagal diam-diam. Checklist berikut membantu kamu membuat integrasi yang lebih aman.
Pahami parent sebelum membuat page
Menurut dokumentasi resmi Notion API, page baru bisa dibuat sebagai child dari page atau data source. Jika page dibuat di dalam data source, property yang dikirim harus cocok dengan schema data source tersebut.
Artinya, jangan hardcode sembarang field. Ambil schema dulu, lalu cocokkan nama property persis seperti di Notion.
Checklist sebelum request
1. Pastikan akses connection
Connection harus punya akses ke page atau database target. Kalau database tidak muncul saat dicari, biasanya masalahnya bukan kode, tapi permission.
2. Validasi schema property
Cek tiga hal:
- nama property sama persis
- tipe data sesuai
- property system-managed tidak ikut dikirim
Contoh: title harus masuk ke property title database. Date perlu format tanggal yang valid. Select harus memakai opsi yang memang ada.
3. Pisahkan properties dan content
Properties adalah metadata database seperti Title, Status, Slug, atau Date. Content adalah isi page: paragraf, heading, list, dan block lain. Jangan mencampur keduanya.
Pola request yang lebih aman
Gunakan langkah bertahap
- Fetch data source schema.
- Susun property map.
- Create page dengan metadata minimal.
- Tambahkan content.
- Fetch ulang page untuk verifikasi.
Karena integrasi tidak cukup dianggap berhasil dari response pertama. Fetch ulang memastikan page benar-benar masuk database, statusnya sesuai, dan field penting tidak kosong.
Simpan page ID, waktu request, payload ringkas, dan error message. Ini membuat debugging jauh lebih cepat saat automation berjalan terjadwal.
Kesalahan yang perlu dihindari
Jangan mengirim property read-only seperti formula, created time, atau last edited time. Jangan juga menganggap semua database punya nama title “Name”; banyak database memakai “Title” atau nama lain.
Kesimpulan
Integrasi Notion yang stabil dimulai dari disiplin kecil: cek parent, baca schema, kirim property sesuai tipe, lalu verifikasi hasil. Dengan pola ini, automation kamu lebih mudah dirawat dan tidak bergantung pada tebakan.
Sebelum membuat automation berikutnya, tulis checklist API kamu sendiri dan uji dengan satu page dummy terlebih dahulu.
