Scopes

A scope is a permission the merchant grants to your installation. Every app-callable operation requires exactly one scope, named at the top of its page in the reference.

13operations an app token may call

9 / 52scopes enforced by an endpoint

999operations in the platform API

The rules

• write_x includes read_x. An app granted write_products may call read routes without a second grant. The token’s scope field already lists the expanded set.
• Customer personal data is its own tier. read_customer_pii is never implied by another scope — not by read_orders, not by read_customers. When order and customer routes open to apps, records will come back with personal data redacted unless the installation holds it.
• There is no write_payments. Payments are platform-owned; an app may read, never write. Requesting an unknown scope is refused, not silently ignored.
• No wildcards, no admin scope. Authorisation is exact set membership.
• Missing scope → 403. Never an empty list that looks like “no data”.

“Grants nothing yet”

Most scopes can already be requested and granted but no endpoint consults them — an app holding read_orders still cannot read orders, because no order route is open to apps yet. The platform says so itself: the token response lists them in scopeNotYetEnforced, and the merchant’s permission screen marks them. Do not build against a scope in that state; build against the reference.

When an endpoint opens, its scope moves to Enforced in this table on the next build of this site.

All scopes

The Turkish text is exactly what the merchant reads on the consent screen.

Scope	Status	Also grants	What the merchant is told
read_products	Enforced	—	Ürünlerinizi, açıklamalarını, varyantlarını ve kategorilerini görebilir.
write_products	Enforced	read_products	Ürün ve kategori ekleyebilir, adlarını, açıklamalarını ve varyantlarını değiştirebilir, yayından kaldırabilir. Ürünlerinizi görme iznini kapsar.
read_collections	Enforced	—	Ürün koleksiyonlarınızı ve içlerinde hangi ürünlerin olduğunu görebilir.
write_collections	Grants nothing yet	read_collections	Koleksiyon oluşturabilir, adını değiştirebilir ve içine ürün ekleyip çıkarabilir — yani vitrindeki listelerin neleri gösterdiğini belirleyebilir. Koleksiyonları görme iznini kapsar.
read_inventory	Enforced	—	Stok adetlerinizi ve hangi depoda ne kadar olduğunu görebilir.
write_inventory	Grants nothing yet	read_inventory	Stok adetlerini değiştirebilir. Bir ürünü stok girerek satışa açabilir ya da sıfırlayarak satıştan düşürebilir. Stokları görme iznini kapsar.
read_prices	Grants nothing yet	—	Ürün fiyatlarınızı, indirimli fiyatları ve fiyat listelerini görebilir.
write_prices	Grants nothing yet	read_prices	Fiyatları değiştirebilir. Değiştirilen fiyat müşteriye anında görünür ve o fiyattan verilen siparişler geçerlidir. Fiyatları görme iznini kapsar.
read_orders	Grants nothing yet	—	Siparişlerinizi, sipariş kalemlerini ve tutarlarını görebilir.
write_orders	Grants nothing yet	read_orders	Sipariş oluşturabilir, sipariş durumunu ve notlarını değiştirebilir. Siparişleri görme iznini kapsar.
read_draft_orders	Grants nothing yet	—	Henüz siparişe dönüşmemiş teklif ve taslak siparişleri görebilir.
write_draft_orders	Grants nothing yet	read_draft_orders	Taslak sipariş ve teklif hazırlayabilir, içeriğini değiştirebilir. Taslakları görme iznini kapsar.
read_fulfillments	Grants nothing yet	—	Siparişlerin hangi kargoyla, ne zaman gönderildiğini ve takip numaralarını görebilir.
write_fulfillments	Grants nothing yet	read_fulfillments	Siparişleri gönderildi olarak işaretleyebilir, kargo ve takip bilgisi girebilir. Gönderileri görme iznini kapsar.
read_returns	Grants nothing yet	—	İade taleplerini, sebeplerini ve durumlarını görebilir.
write_returns	Grants nothing yet	read_returns	İade talebi açabilir, onaylayabilir veya reddedebilir. Para iadesi YAPAMAZ — ödemeye dokunan hiçbir izin bu listede yoktur. İadeleri görme iznini kapsar.
read_customers	Grants nothing yet	—	Müşteri kayıtlarınızı ve sipariş geçmişlerini görebilir. Ad, e-posta, telefon ve adres gibi kişisel bilgiler bu izinle GÖRÜNMEZ; onun ayrı bir izni vardır.
write_customers	Grants nothing yet	read_customers	Müşteri kaydı oluşturabilir, etiketleyebilir ve kayıt bilgilerini değiştirebilir. Müşterileri görme iznini kapsar; kişisel bilgileri görme iznini KAPSAMAZ.
read_customer_pii	Grants nothing yet	—	🔴 Müşterilerinizin ad, e-posta, telefon ve adres bilgilerini görebilir. Bu izin tek başına durur: başka hiçbir izin bunu kendiliğinden vermez, siparişleri veya müşterileri görme izni de dahil. Vermezseniz bu bilgiler gizlenmiş olarak döner.
read_metaobjects	Grants nothing yet	—	Mağazanıza özel tanımladığınız alanları ve yapılandırılmış içerik kayıtlarını görebilir.
write_metaobjects	Enforced	read_metaobjects	Mağazanıza özel alanları ve yapılandırılmış içerik kayıtlarını oluşturabilir ve değiştirebilir. Bunları görme iznini kapsar.
read_content	Grants nothing yet	—	Sayfalarınızı, menülerinizi ve site içeriğinizi görebilir.
write_content	Grants nothing yet	read_content	Sayfa ve menü oluşturabilir, metinlerini değiştirebilir. Değişiklik canlı sayfada müşteriye görünür. İçeriği görme iznini kapsar.
read_blogs	Grants nothing yet	—	Blog yazılarınızı ve kategorilerini görebilir.
write_blogs	Enforced	read_blogs	Blog yazısı yazabilir, düzenleyebilir ve yayımlayabilir. Blogları görme iznini kapsar.
read_translations	Grants nothing yet	—	İçeriğinizin diğer dillerdeki çevirilerini görebilir.
write_translations	Grants nothing yet	read_translations	Çevirileri değiştirebilir — yani bir dilde mağazanızın ne yazdığını belirleyebilir. Çevirileri görme iznini kapsar.
read_media	Grants nothing yet	—	Görsellerinizi, videolarınızı ve yüklediğiniz dosyaları görebilir.
write_media	Enforced	read_media	Görsel ve dosya yükleyebilir, bunların ürün ve sayfalara bağlanmasını değiştirebilir. Görselleri görme iznini kapsar.
read_discounts	Grants nothing yet	—	Kupon ve indirim kurallarınızı görebilir.
write_discounts	Grants nothing yet	read_discounts	Kupon ve indirim oluşturabilir ve değiştirebilir. Oluşturulan bir indirim müşteri tarafından hemen kullanılabilir. İndirimleri görme iznini kapsar.
read_shipping	Grants nothing yet	—	Kargo yöntemlerinizi, teslimat bölgelerinizi ve ücretlerinizi görebilir.
write_shipping	Grants nothing yet	read_shipping	Kargo yöntemi, bölge ve ücretlerini değiştirebilir — yani müşterinin ödeme sayfasında hangi teslimat seçeneğini kaça göreceğini belirler. Kargo ayarlarını görme iznini kapsar.
read_payments	Grants nothing yet	—	Ödeme yöntemi ayarlarınızı ve ödemelerin durumunu görebilir. Ödemeler yalnızca OKUNUR: CIQRA'da ödeme yazma izni diye bir şey yoktur, bu yüzden hiçbir bağlantı tahsilat yapamaz, para iadesi veremez veya bir ödemeyi iptal edemez.
read_forms	Grants nothing yet	—	Form tanımlarınızı ve gelen form yanıtlarını görebilir.
write_forms	Grants nothing yet	read_forms	Form oluşturabilir ve alanlarını değiştirebilir. Formları görme iznini kapsar.
read_support	Grants nothing yet	—	Destek taleplerini ve yazışmalarını görebilir.
write_support	Grants nothing yet	read_support	Destek talebi açabilir, durumunu değiştirebilir ve talebe not düşebilir. Destek taleplerini görme iznini kapsar.
read_loyalty	Grants nothing yet	—	Sadakat programınızı, puanları ve üyelik seviyelerini görebilir.
write_loyalty	Grants nothing yet	read_loyalty	Sadakat puanı ekleyip çıkarabilir ve program kurallarını değiştirebilir — yani müşterinin elindeki puanın değerini belirleyebilir. Sadakat verilerini görme iznini kapsar.
read_reviews	Grants nothing yet	—	Ürün değerlendirmelerini ve puanlarını görebilir.
write_reviews	Grants nothing yet	read_reviews	Değerlendirmeleri onaylayabilir, gizleyebilir veya yanıtlayabilir — yani hangi yorumun vitrinde görüneceğini belirler. Değerlendirmeleri görme iznini kapsar.
read_themes	Grants nothing yet	—	Temanızı ve tema dosyalarınızı görebilir.
write_themes	Grants nothing yet	read_themes	Tema dosyalarını ve ayarlarını değiştirebilir. Temayı YAYIMLAYAMAZ — yayımlama, mağazanızın herkese görünen halini değiştirdiği için hiçbir bağlantıya verilmez. Temayı görme iznini kapsar.
read_sites	Grants nothing yet	—	Mağaza ayarlarınızı ve site yapılandırmanızı görebilir. Bu ayarlar yalnızca OKUNUR: CIQRA'da mağaza ayarı yazma izni diye bir şey yoktur.
read_seo	Grants nothing yet	—	Arama motoru başlıklarınızı, açıklamalarınızı ve yönlendirmelerinizi görebilir.
write_seo	Grants nothing yet	read_seo	Arama motoru başlık ve açıklamalarını, yönlendirmeleri ve site haritası ayarlarını değiştirebilir — yani mağazanızın aramalarda nasıl göründüğünü belirler. SEO ayarlarını görme iznini kapsar.
read_analytics	Grants nothing yet	—	Satış, ziyaret ve dönüşüm raporlarınızı görebilir. Raporlar yalnızca OKUNUR: CIQRA'da ölçüm verisi yazma izni diye bir şey yoktur.
read_webhooks	Enforced	—	Yalnızca kendi oluşturduğu bildirim aboneliklerini listeleyebilir.
write_webhooks	Enforced	read_webhooks	Mağazanızda bir şey olduğunda kendisine bildirim gitmesi için abonelik oluşturabilir ve silebilir. Kendi aboneliklerini görme iznini kapsar.
read_app_data	Grants nothing yet	—	Yalnızca kendi sakladığı ayar ve verileri okuyabilir. Mağazanızın verilerine erişmez.
write_app_data	Grants nothing yet	read_app_data	Yalnızca kendi ayar ve verilerini saklayabilir ve değiştirebilir. Mağazanızın verilerine dokunmaz. Kendi verilerini okuma iznini kapsar.