CleverTap iOS SDK

👋 Introduction

The CleverTap iOS SDK for Mobile Customer Engagement and Analytics solutions

CleverTap brings together real-time user insights, an advanced segmentation engine, and easy-to-use marketing tools in one mobile marketing platform — giving your team the power to create amazing experiences that deepen customer relationships. Our intelligent mobile marketing platform provides the insights you need to keep users engaged and drive long-term retention and growth.

For more information check out our website and documentation.

To get started, sign up here

📝 Note

Starting from iOS SDK version 7.9.1, the minimum supported deployment versions are iOS 15.0, tvOS 15.0, and watchOS 9.0.

📋 Requirements

Following are required for using CleverTap iOS SDK -

• iOS 15.0 or later
• tvOS 15.0 or later
• Xcode 14.0 or later

⚠️ Upgrading to Xcode 27 / iOS 27? See the Xcode 27 / iOS 27 Support guide for the raised minimum deployment targets (iOS 15 / tvOS 15 / watchOS 9), the CocoaPods post_install snippet, and UIScene lifecycle adoption.

🎉 Installation

Details about the different installation methods

CocoaPods users: CocoaPods trunk becomes read-only on December 2, 2026. Add these two lines to the top of your Podfile to keep receiving CleverTap updates:

source 'https://github.com/CleverTap/podspecs.git'
source 'https://cdn.cocoapods.org/'

Existing installs keep working with no change. See CocoaPods for details.

1. Swift Package Manager (recommended)
2. CocoaPods
3. Carthage
4. Manual Installation

🚀 Integration

Add your CleverTap account credentials

Update your .plist file:

• Create a key called CleverTapAccountID with a string value
• Create a key called CleverTapToken with a string value
• Insert the values from your CleverTap Dashboard -> Settings -> Integration Details.

For more details, refer to our installation guide for instructions on installing and using our iOS SDK in your project.

To get started with Custom Proxy domain feature, refer to our Custom domain setup guide for instructions on enabling this feature with AWS proxy setup.

📲 Rich Push Notifications

Apart from Title and Message, you have the below-mentioned options to add to your iOS push notification. Please note that each of these is optional.

• CTNotificationService
• CTNotificationContent

For more details, refer to our Advanced iOS Push Notifications guide.

📍 Geofence

CleverTap Geofence SDK provides Geofencing capabilities to CleverTap iOS SDK. To find the installation & integration steps for CleverTap Geofence SDK, click here.

📲 Push Primer

CleverTap iOS SDK supports Push Primer for push notification runtime permission, refer to Push Primer for more details.

#️⃣ Remote Config Variables

CleverTap iOS SDK supports creating remote config variables, refer to Remote Config Variables for more details and usage examples.

🕹️ Custom Code Templates

CleverTap iOS SDK supports creating Custom Code Templates for in-app notifications, refer to Custom Code Templates for more details and usage examples.

🕹️ User Event Logging APIs

CleverTap iOS SDK supports user-level event log APIs, refer to User Event Logging for more details and usage examples.

𝌡 Example Usage

• A demo application showing the integration of our SDK in Objective-C language.
• A demo application showing the integration of our SDK in Swift language.
• A demo application showing the installation of our SDK via Swift Package Manager.
• A demo application showing the installation of our SDK in Swift UI Application.

🆕 Change Log

Refer to the CleverTap iOS SDK Change Log.

📄 License

CleverTap iOS SDK is released under the MIT license. See LICENSE for details.