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.

36operations an app token may call

17grantable scopes — every one enforced

2247operations 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”.

Every grantable scope is enforced

A scope is offered only when something consults it — an endpoint in the reference, or the webhook delivery gate (read_customers receives customer.*, read_forms receives form.submitted, read_blogs receives blog_post.*, read_customer_pii keeps the personal-data fields in a delivery). Asking for any other scope — in a manifest, an install or a scope change — is refused with unpublished_scope.

Grantable 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.
read_inventory	Enforced	—	Stok adetlerinizi ve hangi depoda ne kadar olduğunu görebilir.
read_orders	Enforced	—	Siparişlerinizi, sipariş kalemlerini ve tutarlarını görebilir.
write_orders	Enforced	read_orders	Sipariş oluşturabilir, sipariş durumunu ve notlarını değiştirebilir. Siparişleri görme iznini kapsar.
read_customers	Enforced	—	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.
read_customer_pii	Enforced	—	🔴 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	Enforced	—	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	Enforced	—	Sayfalarınızı, menülerinizi ve site içeriğinizi görebilir.
read_blogs	Enforced	—	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.
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_forms	Enforced	—	Form tanımlarınızı ve gelen form yanıtlarını görebilir.
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.

Reserved scopes

These names are defined but not grantable until an endpoint enforces them, so you cannot build against them. When an endpoint opens, its scope moves to the table above on the next build of this site. An installation that was granted one before it was reserved keeps it; it still grants nothing.

Scope	Status	Also grants	What the merchant is told
write_collections	Reserved — not grantable	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.
write_inventory	Reserved — not grantable	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	Reserved — not grantable	—	Ürün fiyatlarınızı, indirimli fiyatları ve fiyat listelerini görebilir.
write_prices	Reserved — not grantable	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_draft_orders	Reserved — not grantable	—	Henüz siparişe dönüşmemiş teklif ve taslak siparişleri görebilir.
write_draft_orders	Reserved — not grantable	read_draft_orders	Taslak sipariş ve teklif hazırlayabilir, içeriğini değiştirebilir. Taslakları görme iznini kapsar.
read_fulfillments	Reserved — not grantable	—	Siparişlerin hangi kargoyla, ne zaman gönderildiğini ve takip numaralarını görebilir.
write_fulfillments	Reserved — not grantable	read_fulfillments	Siparişleri gönderildi olarak işaretleyebilir, kargo ve takip bilgisi girebilir. Gönderileri görme iznini kapsar.
read_returns	Reserved — not grantable	—	İade taleplerini, sebeplerini ve durumlarını görebilir.
write_returns	Reserved — not grantable	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.
write_customers	Reserved — not grantable	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.
write_content	Reserved — not grantable	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_translations	Reserved — not grantable	—	İçeriğinizin diğer dillerdeki çevirilerini görebilir.
write_translations	Reserved — not grantable	read_translations	Çevirileri değiştirebilir — yani bir dilde mağazanızın ne yazdığını belirleyebilir. Çevirileri görme iznini kapsar.
read_media	Reserved — not grantable	—	Görsellerinizi, videolarınızı ve yüklediğiniz dosyaları görebilir.
read_discounts	Reserved — not grantable	—	Kupon ve indirim kurallarınızı görebilir.
write_discounts	Reserved — not grantable	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	Reserved — not grantable	—	Kargo yöntemlerinizi, teslimat bölgelerinizi ve ücretlerinizi görebilir.
write_shipping	Reserved — not grantable	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	Reserved — not grantable	—	Ödeme yöntemi ayarlarınızı ve ödemelerin durumunu görebilir. Bu izinle ödemeler yalnızca OKUNUR: hiçbir bağlantı tahsilat yapamaz, para iadesi veremez veya bir ödemeyi iptal edemez.
write_forms	Reserved — not grantable	read_forms	Form oluşturabilir ve alanlarını değiştirebilir. Formları görme iznini kapsar.
read_support	Reserved — not grantable	—	Destek taleplerini ve yazışmalarını görebilir.
write_support	Reserved — not grantable	read_support	Destek talebi açabilir, durumunu değiştirebilir ve talebe not düşebilir. Destek taleplerini görme iznini kapsar.
read_loyalty	Reserved — not grantable	—	Sadakat programınızı, puanları ve üyelik seviyelerini görebilir.
write_loyalty	Reserved — not grantable	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	Reserved — not grantable	—	Ürün değerlendirmelerini ve puanlarını görebilir.
write_reviews	Reserved — not grantable	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	Reserved — not grantable	—	Temanızı ve tema dosyalarınızı görebilir.
write_themes	Reserved — not grantable	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	Reserved — not grantable	—	Mağaza ayarlarınızı ve site yapılandırmanızı görebilir. Bu izin yalnızca OKUR; ayar değişikliği hazırlamak ayrı bir izindir.
read_seo	Reserved — not grantable	—	Arama motoru başlıklarınızı, açıklamalarınızı ve yönlendirmelerinizi görebilir.
write_seo	Reserved — not grantable	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	Reserved — not grantable	—	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_app_data	Reserved — not grantable	—	Yalnızca kendi sakladığı ayar ve verileri okuyabilir. Mağazanızın verilerine erişmez.
write_app_data	Reserved — not grantable	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.
read_settings	Reserved — not grantable	—	Mağaza ayarlarınızı (diller, bildirimler, e-posta şablonları, yasal metinler, çerez ve güvenlik ayarları) görebilir.
write_settings	Reserved — not grantable	read_settings	Mağaza ayarlarında değişiklik hazırlayabilir. Müşterilere giden bildirimleri ve e-postaları, yasal metinleri ve güvenlik ayarlarını yalnızca HAZIRLAR; uygulamayı siz yaparsınız. Ayarları görme iznini kapsar.
read_ai	Reserved — not grantable	—	Yapay zekâ ayarlarınızı, kullanımınızı ve kredi bakiyenizi görebilir.
write_ai	Reserved — not grantable	read_ai	Yapay zekâ ayarlarını değiştirebilir ve yapay zekâ ile metin ya da görsel hazırlatabilir. Üretimler kredi harcar. Yapay zekâ bilgilerini görme iznini kapsar.
read_billing	Reserved — not grantable	—	Planınızı, faturalarınızı ve kullanım bilgilerinizi görebilir.
write_billing	Reserved — not grantable	read_billing	Plan, ek paket ve ödeme yöntemi değişikliklerini yalnızca HAZIRLAR; para çeken hiçbir işlemi kendisi yapamaz. Faturalama bilgilerini görme iznini kapsar.
read_integrations	Reserved — not grantable	—	Bağladığınız uygulamaları, pazar yeri ve ERP entegrasyonlarını ve webhook'larınızı görebilir. Bağlantı anahtarlarını ve şifreleri görmez.
write_integrations	Reserved — not grantable	read_integrations	Entegrasyon ve webhook ayarlarında değişiklik hazırlayabilir; pazar yerlerine veri gönderen eşitleme ve yayın işlemlerini yalnızca HAZIRLAR. Bağlantı anahtarlarına ve şifrelere erişemez. Entegrasyonları görme iznini kapsar.
read_team	Reserved — not grantable	—	Ekip üyelerinizi, rollerini ve işlem geçmişinizi (denetim kaydı) görebilir.
write_team	Reserved — not grantable	read_team	Ekip üyesi davet etme, rol değiştirme ve çıkarma işlemlerini yalnızca HAZIRLAR; yetki vermek yalnızca sizin elinizdedir. Ekibi görme iznini kapsar.
read_domains	Reserved — not grantable	—	Alan adlarınızı, DNS kayıtlarınızı ve alan adı satış kayıtlarınızı görebilir.
write_domains	Reserved — not grantable	read_domains	Alan adı ve DNS değişikliklerini yalnızca HAZIRLAR; alan adı satın alma, yenileme, aktarma ve DNS yayını gibi mağazanızı erişilemez kılabilecek veya para harcatacak işlemleri siz yaparsınız. Alan adlarını görme iznini kapsar.
read_backups	Reserved — not grantable	—	Yedeklerinizin listesini ve durumunu görebilir. Yedek dosyalarını indirmez.
write_backups	Reserved — not grantable	read_backups	Yedek alma ve geri yükleme işlemlerini yalnızca HAZIRLAR; geri yükleme mağazanızın verisini değiştirdiği için yalnızca siz yapabilirsiniz. Yedekleri görme iznini kapsar.
read_marketing	Reserved — not grantable	—	Web push bildirimlerinizi ve pazarlama kanallarınızın ayarlarını görebilir.
write_marketing	Reserved — not grantable	read_marketing	Pazarlama ayarlarında değişiklik hazırlayabilir; ziyaretçilere bildirim gönderen işlemleri yalnızca HAZIRLAR. Pazarlama bilgilerini görme iznini kapsar.
write_payments	Reserved — not grantable	read_payments	Ödeme yöntemi ayarlarında (havale, kapıda ödeme, taksit) değişiklik hazırlayabilir. Sağlayıcı anahtarlarına erişemez, tahsilat yapamaz, para iadesi veremez; geri alınamayan her ödeme işlemini yalnızca HAZIRLAR. Ödeme ayarlarını görme iznini kapsar.