# OneSignal: Turkish > OneSignal is a platform for sending push notifications, emails, in-app messages, and SMS campaigns via a single API, Journey Builder, and a dashboard. ## Turkish - [Turkish / Kullanıcı Kılavuzları (178 pages)](https://documentation.onesignal.com/_llms/tr/kullanici-kilavuzlari.md): Documentation for Turkish / Kullanıcı Kılavuzları. ### Ana Sayfa - [OneSignal Dokümantasyonu](https://documentation.onesignal.com/docs/tr/home.md): OneSignal ile daha hızlı geliştirmeye başlayın. Hızlı başlangıçları, SDK'ları, mesajlaşma kanallarını, API referanslarını ve Journeys ve Live Activities gibi gelişmiş özellikleri keşfedin. ### Geliştirici Kılavuzları #### Geliştirici Belgeleri - [Geliştiriciler](https://documentation.onesignal.com/docs/tr/developers.md): OneSignal Mobil ve Web SDK'larını kurun, App ID ve API anahtarlarınızı bulun, Kullanıcıları tanımlayın ve yayına geçmeden önce entegrasyonunuzu test edin. - [Kimlik doğrulama](https://documentation.onesignal.com/docs/tr/identity-verification.md): OneSignal'e gönderilen Harici Kullanıcı Kimliklerini, e-posta ve SMS aboneliklerini doğrulamak için sunucu tarafından oluşturulan JWT'ler gerektirerek kullanıcı kimliğine bürünmeyi önleyin. ##### Kullanıcı modeli - [Kullanıcı modeli ve geçiş kılavuzu](https://documentation.onesignal.com/docs/tr/user-model-migration-guide.md): OneSignal'in cihaz merkezli modelinden daha kişiselleştirilmiş, çok kanallı etkileşim için yeni kullanıcı merkezli API'lere ve SDK'lara nasıl geçeceğinizi öğrenin. - [Mobil SDK Eşlemesi](https://documentation.onesignal.com/docs/tr/device-user-model-mobile-sdk-mapping.md): OneSignal'ın eski Player Model'i (v3 ve v4) ile modern User Model'i (v5+) arasındaki metod ve özellik adlarını karşılaştırın, daha kolay geçiş için yan yana Swift kod örnekleriyle. - [Web SDK Eşleştirmesi](https://documentation.onesignal.com/docs/tr/device-user-model-web-sdk-mapping.md): Eski Player Model ile yeni User Model arasındaki OneSignal Web SDK yöntemlerini karşılaştırın. TypeScript tabanlı kod örnekleri ve güncellenmiş metod referansları ile uygulamanızı nasıl geçireceğinizi öğrenin. #### Mobil SDK'lar ##### Mobil SDK kurulumu - [Mobil SDK kurulumu](https://documentation.onesignal.com/docs/tr/mobile-sdk-setup.md): Android, iOS, Huawei, Amazon ve React Native, Expo, Flutter, Unity, Cordova ve Capacitor gibi çapraz platform çerçeveleri için OneSignal SDK'yı kurun. - [iOS SDK kurulumu](https://documentation.onesignal.com/docs/tr/ios-sdk-setup.md): OneSignal ile iOS uygulamanıza push bildirimleri ve uygulama içi mesajlar nasıl eklenir. - [Android SDK kurulumu](https://documentation.onesignal.com/docs/tr/android-sdk-setup.md): Push ve uygulama içi mesajlar eklemek için OneSignal Android SDK'sını Android Studio'da kurun; FCM kimlik bilgileri, başlatma ve test gönderimi. - [Unity SDK kurulumu](https://documentation.onesignal.com/docs/tr/unity-sdk-setup.md): iOS, Android, Amazon ve Huawei için Unity uygulamalarına push bildirimleri eklemek üzere OneSignal Unity SDK kurulumunu ve başlatmayı öğrenin. - [React Native SDK kurulumu](https://documentation.onesignal.com/docs/tr/react-native-sdk-setup.md): iOS, Android ve Amazon uygulama platformları için OneSignal React Native SDK'yı entegre etmek için kapsamlı kılavuz. Ön koşulları, yapılandırma adımlarını, platforma özel kurulumu ve yaygın sorunları gidermeyi içerir. - [Expo SDK kurulumu](https://documentation.onesignal.com/docs/tr/react-native-expo-sdk-setup.md): Push bildirimleri ve uygulama içi mesajlar için Expo SDK 53+ ve EAS Build kullanarak OneSignal Expo SDK'yı iOS ve Android uygulamalarınıza entegre edin. - [Flutter SDK kurulumu](https://documentation.onesignal.com/docs/tr/flutter-sdk-setup.md): iOS ve Android için Flutter uygulamanıza OneSignal Flutter SDK'sını ekleme talimatları - [Flutterflow SDK kurulumu](https://documentation.onesignal.com/docs/tr/flutterflow-sdk-setup.md): iOS ve Android için Flutterflow uygulamanıza OneSignal Flutter SDK'sını ekleme talimatları - [Cordova SDK kurulumu](https://documentation.onesignal.com/docs/tr/cordova-sdk-setup.md): iOS ve Android için Cordova ve Ionic uygulamalarına push bildirimleri eklemek üzere OneSignal Cordova SDK'sını kurun; yapılandırma ve test adımları dahil. - [Capacitor SDK kurulumu](https://documentation.onesignal.com/docs/tr/capacitor-sdk-setup.md): iOS ve Android için Capacitor uygulamalarına push bildirim eklemek üzere OneSignal Capacitor SDK'sını kurun. - [.NET MAUI SDK kurulumu](https://documentation.onesignal.com/docs/tr/net-sdk-setup.md): iOS, Android ve Desktop için çapraz platform MAUI uygulamanıza OneSignal .NET SDK'yı ekleme talimatları. - [Amazon SDK kurulumu](https://documentation.onesignal.com/docs/tr/amazon-sdk-setup.md): Push bildirimleri ve uygulama içi mesajlaşma yetenekleri için OneSignal SDK'sını Amazon Fire OS uygulamanıza entegre etmek için adım adım kılavuz. - [Huawei SDK kurulumu](https://documentation.onesignal.com/docs/tr/huawei-sdk-setup.md): Android Studio için OneSignal Huawei SDK Kurulum Kılavuzu. ###### Platform kimlik bilgileri kurulumu - [Android Firebase kimlik bilgileri](https://documentation.onesignal.com/docs/tr/android-firebase-credentials.md): OneSignal'da Firebase Cloud Messaging (FCM) Hizmet Hesabı kimlik bilgilerini yapılandırarak Google Play Store'daki uygulamalar için Android push bildirimlerini etkinleştirin. - [iOS p8 token tabanlı APNs bağlantısı](https://documentation.onesignal.com/docs/tr/ios-p8-token-based-connection-to-apns.md): OneSignal aracılığıyla iOS veya macOS uygulamanızı Apple Push Notification service'e (APNs) bağlamak için bir .p8 kimlik doğrulama anahtarı ayarlayın. - [iOS p12 sertifika oluşturma](https://documentation.onesignal.com/docs/tr/ios-p12-generate-certificates.md): iOS veya macOS uygulamanızı OneSignal aracılığıyla Apple Push Notification service (APNs) ile bağlamak için bir .p12 push sertifikası oluşturun ve yükleyin. - [Amazon API anahtarı oluşturma](https://documentation.onesignal.com/docs/tr/generate-an-amazon-api-key.md): Adım adım kılavuz - [Huawei yetkilendirmesi](https://documentation.onesignal.com/docs/tr/authorize-onesignal-to-send-huawei-push.md): Push bildirimleri için Huawei uygulamanızı OneSignal'a bağlamak için adım adım kılavuz, PushKit kurulumu, API anahtarı yapılandırması ve Çin'deki kullanıcıları olan uygulamalar için Huawei'nin isteğe bağlı mesaj öz-sınıflandırması dahil. ##### Mobil SDK referansı - [Mobil SDK referansı](https://documentation.onesignal.com/docs/tr/mobile-sdk-reference.md): OneSignal Mobil SDK için başlatma, kullanıcı kimliği, abonelikler, etiketler, izinler, uygulama içi mesajlar, canlı aktiviteler ve daha fazlasını içeren kapsamlı API referansı. Android, iOS, Unity, React Native, Flutter ve Cordova/Ionic platformlarını destekler. - [Mobil Servis Eklentileri](https://documentation.onesignal.com/docs/tr/service-extensions.md): iOS ve Android'de push bildirimlerini gösterilmeden önce yakalayıp özelleştirin; zengin medya, onaylanmış alım, özel stil ve arka plan veri işleme sağlayın. - [Bildirim tepsisini yönetme](https://documentation.onesignal.com/docs/tr/managing-the-notification-tray.md): OneSignal mobil push bildirimlerinin Android ve iOS'ta bildirim tepsisindeki davranışı: tıklama ve kapatma işleme, geri yüklenen bildirimler, rozetler, bildirimleri programatik olarak temizleme ve servis uzantıları. - [OSNotification payload](https://documentation.onesignal.com/docs/tr/osnotification-payload.md): Tüm payload alanları, Android ve iOS'a özel özellikler, özel veri ve tıklama eylemleri dahil olmak üzere OneSignal'in OSNotification nesnesi için referans. - [iOS: App Clip Desteği](https://documentation.onesignal.com/docs/tr/app-clip-support.md): iOS App Clip'lerinde OneSignal push bildirimlerini nasıl etkinleştireceğinizi ve yapılandıracağınızı öğrenin. Kurulum adımlarını, sınırlamaları ve Target-Content-ID gibi gelişmiş deneyimler için desteği kapsar. ##### Mobil SDK hata ayıklama - [Mobil SDK sorun giderme](https://documentation.onesignal.com/docs/tr/mobile-troubleshooting.md): iOS, Android ve çapraz platform çerçevelerinde push teslimat hataları, APNS hataları ve uygulama içi mesajlaşma sorunları dahil olmak üzere yaygın OneSignal Mobil SDK sorunlarını çözün. - [Hata Ayıklama Günlüğü Alma](https://documentation.onesignal.com/docs/tr/capturing-a-debug-log.md): OneSignal SDK'sını kullanarak mobil uygulamanızdan ayrıntılı hata ayıklama günlüklerini nasıl yakalayacağınızı öğrenin. Bu kılavuz, ayrıntılı günlük kaydını etkinleştirme, sorunları yeniden oluşturma ve Android ve iOS platformlarında push bildirim sorunlarını gidermek için günlükleri paylaşma konula… #### Web SDK'lar - [Web SDK referansı](https://documentation.onesignal.com/docs/tr/web-sdk-reference.md): Başlatma, oturum açma, kullanıcı özellikleri, push abonelikleri, slidedown istemleri ve olay dinleyicilerini kapsayan OneSignal Web SDK v16 API referansı. ##### Web SDK kurulumu - [Web SDK kurulumu](https://documentation.onesignal.com/docs/tr/web-sdk-setup.md): JavaScript SDK başlatma, service worker kurulumu ve kontrol paneli yapılandırmasıyla web sitenize OneSignal web push bildirimleri ekleyin. - [iOS web push kurulumu](https://documentation.onesignal.com/docs/tr/web-push-for-ios.md): Manifest dosyası kurulumu, kullanıcı katılım stratejileri ve Safari, Chrome ve Edge tarayıcıları için implementasyon en iyi uygulamalarını içeren iOS ve iPadOS cihazlarında web push bildirimlerini etkinleştirme hakkında eksiksik kılavuz. - [OneSignal service worker](https://documentation.onesignal.com/docs/tr/onesignal-service-worker.md): Web sitenizin OneSignal aracılığıyla web push bildirimleri alıp görüntüleyebilmesi için OneSignalSDKWorker.js dosyasını ayarlayın ve yapılandırın. - [OneSignal Web SDK ile özel kod web push kurulumu](https://documentation.onesignal.com/docs/tr/web-push-custom-code-setup.md): OneSignal web push bildirimlerini özel kodla kurun. JavaScript SDK'yı ekleyin, service worker'ı yapılandırın ve OneSignal'i sitenizde başlatın. - [Google Tag Manager kurulumu](https://documentation.onesignal.com/docs/tr/google-tag-manager.md): Google Tag Manager (GTM) kullanarak web sitenize OneSignal Web Push'u ekleyin; service worker kurulumu, başlatma ve etiketleri güvenli bir şekilde ayarlamayı içerir. - [Angular Web SDK kurulumu](https://documentation.onesignal.com/docs/tr/angular-setup.md): onesignal-ngx paketini kullanarak OneSignal Web Push Bildirimlerini Angular uygulamanıza entegre edin. Sorunsuz push bildirimleri sunmak için service worker'ları nasıl yükleyeceğinizi, yapılandıracağınızı ve sorunlarını gidereceğinizi öğrenin. - [ReactJS ve NextJS Kurulumu](https://documentation.onesignal.com/docs/tr/react-js-setup.md): OneSignal push bildirimlerini ReactJS veya NextJS web uygulamanızla nasıl entegre edeceğinizi, başlatma, service worker kurulumu ve TypeScript desteği dahil olmak üzere öğrenin. - [Vue JS Web SDK kurulumu](https://documentation.onesignal.com/docs/tr/vue-js-setup.md): OneSignal Web Push Bildirimlerini onesignal-vue veya @onesignal/onesignal-vue3 eklentisini kullanarak Vue.js uygulamanıza entegre edin. Sorunsuz push teslimatı için service worker'ları nasıl yükleyeceğinizi, yapılandıracağınızı ve özelleştireceğinizi öğrenin. ##### Web SDK hata ayıklama - [Web SDK sorun giderme](https://documentation.onesignal.com/docs/tr/troubleshooting-web-push.md): Service worker hataları, origin uyuşmazlıkları, MIME türleri ve gösterilmeyen bildirimler dahil OneSignal Web Push sorunlarını giderin. - [Önbelleği temizleme ve push izinlerini sıfırlama](https://documentation.onesignal.com/docs/tr/clearing-cache-and-resetting-push-permissions.md): Temiz test ortamları sağlamak ve web push bildirimi sorunlarını çözmek için Chrome, Firefox ve Safari'de tarayıcı push izinlerini, service worker'ları ve site verilerini nasıl sıfırlayacağınızı öğrenin. - [Web push webhook'ları](https://documentation.onesignal.com/docs/tr/webhooks.md): Kullanıcılar web push bildirimlerini görüntülediğinde, tıkladığında veya kapattığında gerçek zamanlı bildirimler almak için HTTP webhook'larını kurun. Chrome, Firefox ve Safari tarayıcı desteği için örneklerle eksiksiz kılavuz. #### Canlı Etkinlikler - [Live Activities geliştirici kurulumu](https://documentation.onesignal.com/docs/tr/live-activities-developer-setup.md): iOS Live Activities'i OneSignal ile kurarak kilit ekranında ve Dynamic Island'da gerçek zamanlı güncellemeleri görüntüleyin. - [Platformlar arası Live Activity SDK kurulumu](https://documentation.onesignal.com/docs/tr/cross-platform-live-activity-setup.md): React Native, Flutter, Unity, Cordova, Capacitor veya .NET MAUI uygulamalarına iOS Live Activities ekleyin; SDK, ActivityKit yaşam döngüsünü yönetir. - [Android Live Update bildirimleri](https://documentation.onesignal.com/docs/tr/android-live-notifications.md): OneSignal push ile Android Live Updates oluşturun: Notification Service Extension kullanarak tek bir kalıcı bildirimi yerinde güncelleyin. #### Masaüstü & Watch Kurulumu - [macOS uygulama kurulumu](https://documentation.onesignal.com/docs/tr/macos-app-setup.md): Mac Catalyst veya doğrudan API erişimi kullanarak OneSignal'i macOS uygulamanıza nasıl entegre edeceğinizi öğrenin. Platformları yapılandırma, SDK kurma ve push bildirimleri gönderme için adım adım rehberlik. - [Windows uygulama kurulumu](https://documentation.onesignal.com/docs/tr/windows-app-setup.md): Windows Push Notification Service (WNS) ve OneSignal REST API'sini kullanarak OneSignal push bildirimlerini Universal Windows Platform (UWP) uygulamanıza entegre etmeye yönelik eksiksiz kılavuz - [watchOS ve Wear OS Desteği](https://documentation.onesignal.com/docs/tr/watchos-and-wear-os-support.md): Kurulum talimatları ve API entegrasyonu dahil olmak üzere bağımsız Apple watchOS ve Android Wear OS uygulamaları için OneSignal push bildirimlerini uygulama hakkında eksiksiz kılavuz. ### Eğitimler #### Eğitimler - [Öğreticiler ve kullanım senaryoları](https://documentation.onesignal.com/docs/tr/tutorials.md): OneSignal özelliklerini uygulamanıza ve etkileşimi, elde tutmayı ve geliri artırmanıza yardımcı olacak adım adım öğreticileri ve en iyi uygulama örneklerini keşfedin. #### 🏢 Sektörlere Göre - [Oyun stratejileri](https://documentation.onesignal.com/docs/tr/gaming-industry.md): Oyun mesajlaşması için uygulama merkezi: oyuncu kimlikleri, yaşam döngüsü Etiketleri, davranışsal Özel Olaylar, segmentler ve Journey kılavuzları. - [Finans ve fintech stratejileri](https://documentation.onesignal.com/docs/tr/financial-fintech-industry.md): Finans ve fintech mesajlaşması için uygulama merkezi: kullanıcı kimlikleri, KYC ve güvenlik Etiketleri, işlem Özel Olayları, segmentler ve Journey kılavuzları. - [Haber ve medya stratejileri](https://documentation.onesignal.com/docs/tr/news-and-media-industry.md): Haber ve medya mesajlaşması için uygulama merkezi: kullanıcı kimlikleri, kategori ilgi Etiketleri, okuma davranışı Özel Olayları ve Journey kılavuzları. #### 📈 Katılımı ve Elde Tutmayı Artırın - [Terk edilen sepet eğitimi](https://documentation.onesignal.com/docs/tr/abandoned-cart.md): OneSignal ile terk edilen sepet bildirimleri kullanarak kaybedilen satışları kurtarın. Sepet etkinliğini nasıl izleyeceğinizi, doğru segmenti nasıl oluşturacağınızı ve Journeys ile zamanında hatırlatmaları nasıl göndereceğinizi öğrenin. - [Etkinlik akışı oluşturma](https://documentation.onesignal.com/docs/tr/create-an-activity-feed.md): OneSignal'ın REST API'si, Event Streams veya cihaz içi mantığı kullanarak kullanıcı bildirim geçmişini izlemek ve görüntülemek için uygulama içi bir etkinlik akışı oluşturmayı öğrenin. - [Rezervasyon onayları](https://documentation.onesignal.com/docs/tr/booking-confirmations.md): Gerçek zamanlı rezervasyon durumuna göre rezervasyon onayı veya kurtarma e-postaları göndermek için Özel Etkinlikler, Journeys ve Veri Beslemelerini kullanın. - [Buton odaklı onboarding karuseli oluşturma](https://documentation.onesignal.com/docs/tr/in-app-onboarding-carousel-tutorial.md): Buton navigasyonu ve otomatik kapatma özellikli HTML Uygulama İçi Mesajlar kullanarak çok adımlı bir onboarding akışı oluşturun. - [Sosyal etkinlik](https://documentation.onesignal.com/docs/tr/social-activity.md): Beğeni, takip, doğrudan mesaj ve oyun etkinlikleri gibi sosyal eylemler için custom_data ile push, e-posta ve SMS bildirimleri gönderin. - [Uygulama güncellemelerini teşvik etmek için eski uygulama sürümlerini hedefleyin](https://documentation.onesignal.com/docs/tr/app-version-update.md): Uygulama içi mesajları kullanarak eski uygulama sürümlerini tespit edin ve kullanıcıları güncelleme yapmaya yönlendirin. iOS ve Android için platforma özgü segmentler içerir. - [Daha fazla uygulama mağazası değerlendirmesi alın](https://documentation.onesignal.com/docs/tr/example-app-store-review.md): OneSignal uygulama içi mesajlarla yerel iOS ve Android değerlendirme istemleri kullanarak kullanıcılara uygulamanızı değerlendirmelerini önerin, sürtüşmeyi azaltın ve puanları yükseltin. - [Banner uygulama içi mesajlarla kullanıcıları yönlendirme](https://documentation.onesignal.com/docs/tr/example-create-a-tutorial.md): Uygulama arayüzünüzü engellemeden bağlamsal üst ve alt banner uygulama içi mesajlarla kullanıcıları yönlendirin. #### 🔔 Kritik veya Zaman Sınırlı Mesajları Gönderin - [İşlemsel mesajlar](https://documentation.onesignal.com/docs/tr/transactional-messages.md): OneSignal'in API'sini kullanarak push, e-posta veya SMS aracılığıyla kişiselleştirilmiş verilerle OTP'ler, fatura güncellemeleri ve hatırlatıcılar gibi işlemsel mesajların nasıl gönderileceğini öğrenin. - [Yedek mesajlar: Kanallar arasında teslimati sağlama](https://documentation.onesignal.com/docs/tr/push-fallback-method.md): Push bildirimleri başarısız olduğunda kritik mesajların e-posta veya SMS ile teslim edilmesini sağlamak için OneSignal ile bir yedek strateji uygulayın. Güvenilir kullanıcı etkileşimi için Journeys, API'ler ve segmentasyon kullanarak çapraz kanal mesajlaşması kurulumunu öğrenin. - [Konum tabanlı mesajlar](https://documentation.onesignal.com/docs/tr/location-triggered-event.md): OneSignal ile kullanıcıları ülke, GPS koordinatları veya coğrafi sınıra göre segmentleyin ve konum tetiklemeli push bildirimleri gönderin. #### 🧠 Hedefleme ve Kişiselleştirmeyi Artırın - [Kullanıcıları sayfa konusuna ve abonelik kaynağına göre etiketleyin](https://documentation.onesignal.com/docs/tr/auto-segment-users-by-page-visit.md): Kullanıcıları ziyaret ettikleri sayfalara ve push bildirimlerine abone oldukları sayfaya göre OneSignal'de etiketleyin, ardından hedefli kampanyalar için segmentleyin. - [Uygulama içi mesajlarla konum izinleri isteme](https://documentation.onesignal.com/docs/tr/location-opt-in-prompt.md): Yerel Android veya iOS konum izin isteğini tetiklemeden önce OneSignal'de yumuşak bir ön istem kullanarak kullanıcıların mobil uygulamanızda konum takibini etkinleştirmelerine rehberlik edin. - [Geri bildirim istemek için anket oluşturun](https://documentation.onesignal.com/docs/tr/example-create-a-survey.md): Analitik ve segmentasyon için Carousel, Düğme Tıklama Eylemleri, Outcome'lar ve Etiketleri kullanarak çok sayfalı bir uygulama içi anket oluşturun. - [Belirli Android üreticilerini ve cihazları hedefleyin](https://documentation.onesignal.com/docs/tr/example-target-certain-android-manufacturers-and-devices.md): Uygulamalar kaydırıldığında push bildirimlerini engellemesiyle bilinen üreticilerden Android cihazları belirleyin ve hedefleyin, kullanıcıları doğru ayarları etkinleştirme konusunda eğitmek için uygulama içi mesajlar kullanın. #### 🛠️ Kullanıcı Deneyimini ve Onboarding'ı Artırın - [Email için onaylanmış opt-in kurulumu](https://documentation.onesignal.com/docs/tr/double-opt-in-email.md): Etkileşimi, uyumluluğu ve liste kalitesini artırmak için OneSignal'da Etiketler, Segmentler ve Journeys kullanarak double opt-in (onaylanmış opt-in) sürecini nasıl uygulayacağınızı öğrenin. - [Tercih merkezi](https://documentation.onesignal.com/docs/tr/preference-center.md): Bildirim konularını, frekansları, kanalları ve veri gizliliği ayarlarını yönetmek için OneSignal API'lerini kullanarak uygulamanızda veya web sitenizde özel bir kullanıcı tercih merkezini nasıl uygulayacağınızı öğrenin. - [Doğrulama, sihirli bağlantı, OTP ve çift onay mesajları gönderin](https://documentation.onesignal.com/docs/tr/example-verification-magic-link-otp.md): Tek kullanımlık şifreler, sihirli bağlantılar ve şablonlar ve API örnekleri ile çift onay akışları dahil olmak üzere OneSignal kullanarak e-posta ve SMS doğrulama mesajları örnekleri. - [iOS: Görsel Döngü Push Bildirimleri](https://documentation.onesignal.com/docs/tr/ios-image-carousel-push-notifications.md): Swift kullanarak OneSignal iOS push bildirimlerinde görsel döngüsünün nasıl uygulanacağı. ### API Reference #### Using the REST APIs - [REST API overview](https://documentation.onesignal.com/reference/rest-api-overview.md): Programmatic access to OneSignal messaging, user management, segments, Journeys, and data exports over HTTPS with rate limiting and retry support. - [Rate limits and error handling](https://documentation.onesignal.com/reference/rate-limits.md): Understand OneSignal API and application rate limits, common errors, retry behavior, and how to safely recover from failures without sending duplicate messages or disabling your app. #### API reference ##### Messages - [Sending messages with the OneSignal API](https://documentation.onesignal.com/reference/create-message.md): Send push notifications, emails, SMS, and Live Activities with the OneSignal API. Covers audience targeting, message composition, scheduling, and response handling. - [Idempotent API requests](https://documentation.onesignal.com/reference/idempotent-notification-requests.md): Prevent duplicate messages or custom events when retrying API requests. - [Push notification](https://documentation.onesignal.com/reference/push-notification.md): Send a message using the push notification channel. - [Email](https://documentation.onesignal.com/reference/email.md): Send a message using the email channel. - [SMS](https://documentation.onesignal.com/reference/sms.md): Send a message using the SMS channel. - [View message](https://documentation.onesignal.com/reference/view-message.md): View the details of a single message and the Outcomes associated with it. - [View messages](https://documentation.onesignal.com/reference/view-messages.md): View the details for a collection of messages. - [Cancel message](https://documentation.onesignal.com/reference/cancel-message.md): Stop a scheduled or currently outgoing message. - [Message history](https://documentation.onesignal.com/reference/message-history.md): View which subscriptions received a particular message - [Estimated recipients](https://documentation.onesignal.com/reference/count-unsaved.md): Returns the estimated number of recipients for a notification's targeting, without creating or sending anything. ##### Live Activities - [Start Live Activity](https://documentation.onesignal.com/reference/start-live-activity.md): Remotely start an iOS Live Activity with the OneSignal REST API, also known as push-to-start. Covers required body fields, choosing an activity_id, and audience targeting. - [Update Live Activity](https://documentation.onesignal.com/reference/update-live-activity-api.md): Update the content of a running iOS Live Activity or end it with the OneSignal REST API. Covers required body fields, update priority, and dismissal timing. ##### Custom Events - [Create custom events](https://documentation.onesignal.com/reference/create-custom-events.md): The Custom Events API allows you to record user events. Custom events can represent any action users take in your application, such as completing a purchase, viewing content, or achieving milestones. ##### Users - [Create user](https://documentation.onesignal.com/reference/create-user.md): Create a new user or modify the subscriptions associated with an existing User. - [View user](https://documentation.onesignal.com/reference/view-user.md): Retrieve a user including aliases, properties, and subscriptions. - [Update user](https://documentation.onesignal.com/reference/update-user.md): Modify a user's properties. - [Delete user](https://documentation.onesignal.com/reference/delete-user.md): Delete a user including all associated properties, subscriptions, and identity. - [View user identity](https://documentation.onesignal.com/reference/fetch-aliases.md): Retrieve all aliases associated with a user using a known alias, such as an `external_id`, `onesignal_id`, or a custom alias. This API helps you map back to a user's full identity from any one piece of identifying information. - [View user identity (by subscription)](https://documentation.onesignal.com/reference/fetch-identity-by-subscription.md): Retrieve all aliases linked to a user using a known `subscription_id`. This is useful when the user's identity is unknown but you have access to one of their push, email, or SMS subscriptions. - [Create or update alias](https://documentation.onesignal.com/reference/create-alias.md): Add or update aliases on an existing user when you already know one of that user's aliases, such as an external_id, onesignal_id, or custom alias. Updates the identity object only. - [Create alias (by subscription)](https://documentation.onesignal.com/reference/create-alias-by-subscription.md): Create or update an alias for a user using a known subscription ID. - [Delete alias](https://documentation.onesignal.com/reference/delete-alias.md): Remove a specific alias from a user. ##### Subscriptions - [Create Subscription by alias](https://documentation.onesignal.com/reference/create-subscription.md): Attach a new subscription (email, SMS, or push) to an existing OneSignal user identified by an alias. - [Update Subscription by ID](https://documentation.onesignal.com/reference/update-subscription.md): Update properties on an existing OneSignal subscription using its subscription_id. Commonly used to enable or disable a subscription when managing outside of the OneSignal SDK. - [Update Subscription by token](https://documentation.onesignal.com/reference/update-subscription-by-token.md): Update properties on an existing Subscription using its token. Commonly used to enable or disable subscription status when managing outside of the OneSignal SDK. - [Delete Subscription](https://documentation.onesignal.com/reference/delete-subscription.md): Delete a specific subscription by its subscription_id. This stops messages from being sent to that subscription but does not prevent future subscriptions with the same token. - [Transfer Subscription](https://documentation.onesignal.com/reference/transfer-subscription.md): Transfer a Subscription to a different user within the same OneSignal app. Useful for associating existing Subscriptions like push, email, or SMS with a new or updated user identity. - [Unsubscribe email with token](https://documentation.onesignal.com/reference/unsubscribe-with-token.md): Unsubscribe an email address from future messages by calling this API from your custom unsubscribe page. Automatically disables the associated email subscription using a token-based approach. ##### Templates - [Create template](https://documentation.onesignal.com/reference/create-template.md): Create reusable message templates for push, email, and SMS channels. Templates can be accessed through both the dashboard and API using a `template_id`. - [Update template](https://documentation.onesignal.com/reference/update-template.md): Update existing OneSignal message templates for push, email, or SMS. Changes apply immediately across dashboard and API usage via the `template_id` reference. - [View templates](https://documentation.onesignal.com/reference/view-templates.md): Retrieve a paginated list of message templates from your OneSignal app. This endpoint returns summary information for each template, including ID, name, creation, and update timestamps. - [View template](https://documentation.onesignal.com/reference/view-template.md): Retrieve the details of a specific message template in your OneSignal app using its template ID. This API returns the template content, target channel, and timestamps for creation and last update. - [Delete template](https://documentation.onesignal.com/reference/delete-template.md): Permanently delete a specific message template from your OneSignal app using its template ID. Templates used in Journeys must be removed from those Journeys before deletion. - [Copy template to another app](https://documentation.onesignal.com/reference/copy-template-to-another-app.md): Create a duplicate of a template in another app. The new template will be completely separate from the original (including having a new template_id) but will be created with all the same content. ##### Segments - [View segments](https://documentation.onesignal.com/reference/view-segments.md): Retrieve a list of segments associated with a specific OneSignal app. Useful for programmatically accessing segment metadata such as name, creation date, and status. - [View segment](https://documentation.onesignal.com/reference/view-segment.md): Retrieve details for a single segment by its ID, including subscriber count and optionally segment metadata and filters. - [Create segment](https://documentation.onesignal.com/reference/create-segments.md): Programmatically create segments in your OneSignal app using flexible filters and targeting rules. - [Update segment](https://documentation.onesignal.com/reference/update-segment.md): Update an existing segment's name and/or filters. The name parameter is always required. When filters are provided, all existing filters are replaced with the new ones. - [Delete segment](https://documentation.onesignal.com/reference/delete-segments.md): Delete segments from OneSignal. Does not delete users or subscriptions. ##### Journeys - [View journeys](https://documentation.onesignal.com/reference/view-journeys.md): Retrieve a paginated list of journeys for an app, with cursor-based pagination and a lightweight summary representation of each journey. - [View journey](https://documentation.onesignal.com/reference/view-journey.md): Retrieve the full configuration of a single journey by its UUID, including its audience, schedule, and node graph. - [View journey stats](https://documentation.onesignal.com/reference/view-journey-stats.md): Retrieve performance stats for a single journey, including journey-level counts, per-node counts, per-branch counts, and channel delivery stats. - [Create journey](https://documentation.onesignal.com/reference/create-journey.md): Create a new journey with an audience and a node graph. Journeys are always created in the draft state. - [Duplicate journey](https://documentation.onesignal.com/reference/duplicate-journey.md): Copy an existing journey into a new draft. You can apply overrides to the copy in the same request. - [Update journey](https://documentation.onesignal.com/reference/update-journey.md): Apply a partial update to a journey with JSON Merge Patch, and activate a draft journey by transitioning its state. - [Update journey node](https://documentation.onesignal.com/reference/update-journey-node.md): Apply a partial update to a single journey node, located by its server-assigned id, with JSON Merge Patch. - [Delete journey](https://documentation.onesignal.com/reference/delete-journey.md): Permanently delete a journey by its UUID. Deletion cannot be undone; archive a running journey instead if you need to keep its data. ##### Configuration - [View apps](https://documentation.onesignal.com/reference/view-apps.md): Retrieve a list of all OneSignal apps associated with your account, including key app details like name, App ID, subscription counts, and timestamps. Useful for managing multiple apps through the OneSignal API. - [View an app](https://documentation.onesignal.com/reference/view-an-app.md): View the details of a single OneSignal app - [Create an app](https://documentation.onesignal.com/reference/create-an-app.md): Programmatically create a new OneSignal app via the REST API. This guide explains required fields, supported platform configurations (Web, Android, iOS), and how to properly authenticate using your Organization API key. - [Update an app](https://documentation.onesignal.com/reference/update-an-app.md): Use to update the name or push platform configuration of an existing app. This guide explains required parameters and platform-specific update rules - [View API keys](https://documentation.onesignal.com/reference/view-api-keys.md): View the details of all of your current app API keys (Rich Authentication Token) for a single OneSignal app. - [Create API key](https://documentation.onesignal.com/reference/create-api-key.md): Use the OneSignal API to create a new Rich Authentication Token (App API Key) for a specific app. This guide explains how to authenticate with the Organization API key and configure optional IP allowlists using CIDR notation. - [Delete API key](https://documentation.onesignal.com/reference/delete-api-key.md): Delete a specific Rich Authentication Token (App API Key) for a OneSignal app. Requires your Organization API Key and the token's unique ID, not the token value itself. - [Update API key](https://documentation.onesignal.com/reference/update-api-key.md): Update a Rich Authentication Token (App API Key) for a OneSignal app. Modify the token's name or IP allowlist settings using your Organization API Key. - [Rotate API key](https://documentation.onesignal.com/reference/rotate-api-key.md): Rotate an existing App API Key (Rich Authentication Token) for a OneSignal app. Useful when a token is compromised or needs replacement without creating a new key from scratch. ##### Analytics - [Export subscriptions CSV](https://documentation.onesignal.com/reference/csv-export.md): Generate a GZip-compressed CSV export of your current subscription data using this API endpoint. - [Export audience activity CSV](https://documentation.onesignal.com/reference/export-csv-of-events.md): Export a compressed CSV report of audience-level delivery and engagement data for a specific message. This includes sent, delivered, clicked, failed, and unsubscribed events across Push, Email, and SMS channels. - [View outcomes](https://documentation.onesignal.com/reference/view-outcomes.md): View and export push notification outcome metrics such as clicks, conversions, and custom events. ##### Deprecated - [View players](https://documentation.onesignal.com/reference/view-devices.md): GET `https://onesignal.com/api/v1/players?app_id={app_id}&limit={limit}&offset={offset}` - [View player](https://documentation.onesignal.com/reference/view-device.md): GET https://onesignal.com/api/v1/players/{player_id} - [Add a player](https://documentation.onesignal.com/reference/add-a-device.md): POST `https://onesignal.com/api/v1/players` - [Edit player](https://documentation.onesignal.com/reference/edit-device.md): put https://onesignal.com/api/v1/players/{player_id} - [Edit tags with external user id](https://documentation.onesignal.com/reference/edit-tags-with-external-user-id.md): put https://onesignal.com/api/v1/apps/{app_id}/users/{external_user_id} - [Delete player record](https://documentation.onesignal.com/reference/delete-user-record.md): delete https://onesignal.com/api/v1/players/{player_id}?app_id={app_id} #### SDKs - [Server SDK reference](https://documentation.onesignal.com/docs/en/server-sdk-reference.md): Install, configure, and use OneSignal server SDKs to send push notifications, emails, and SMS from your backend in Node.js, Python, Java, Go, PHP, Ruby, C#, and Rust. ### Release Notes #### Release Notes - [Changelog](https://documentation.onesignal.com/release-notes/changelog.md): Follow the OneSignal changelog for new features, product updates, and bug fixes across push, email, SMS, in-app messages, Journeys, and analytics. - [SDK Releases](https://documentation.onesignal.com/release-notes/sdk-releases.md): View the latest OneSignal SDK releases and updates. ## OpenAPI Specs - [openapi](/openapi.json) ## Optional - [Blog](https://onesignal.com/blog) - [GitHub](https://github.com/OneSignal) - [YouTube](https://www.youtube.com/@onesignalofficial/playlists)