Just wanted to shoot you a quick email to tell you all thanks for getting us up and running with push notifications. We ended up purchasing a premium account. We very much like the features you offer and found it INCREDIBLY easy to integrate into our current app.

Thank you for creating such a robust and easy to use service.

Wish you all the best!

Brady Kelley

Online Marketing Systems Consultant

CleanBrain Software Inc.


Native iOS SDK

Download iOS8 SDK Download Sample SDK API Docs

As per May 14th 2014 updated Pushwoosh SDK no longer performs automatic push notifications registration.

If you wish to force old behavior:

1. Add Pushwoosh_AUTO key to the Info.plist with the value true

2. Add -ObjC flag to the Linker Flags in your project.

3. Skip steps 3.1 and 3.2 of the current guide.

NOTE: Simulator is not able neither to subscribe nor receive push notifications. Push Notifications SDK supports iOS 4.0 and higher.

To integrate Pushwoosh into your application you need to do simple following steps:

1. Add Pushwoosh.framework to your project.

2. In your Info.plist add the following key Pushwoosh_APPID with your Pushwoosh Application ID string value

3.1. Add the following import definitions to the AppDelegate.m file.

@import CoreLocation;
@import SystemConfiguration;
@import AVFoundation;
@import ImageIO;

#import <Pushwoosh/PushNotificationManager.h>

3.2. Add the following code to the didFinishLaunchingWithOptions function.

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
	//lots of your initialization code

	//-----------PUSHWOOSH PART-----------
	// set custom delegate for push handling, in our case - view controller
	PushNotificationManager * pushManager = [PushNotificationManager pushManager];
	pushManager.delegate = self;
	// handling push on app start
	[[PushNotificationManager pushManager] handlePushReceived:launchOptions];
	// make sure we count app open in Pushwoosh stats
	[[PushNotificationManager pushManager] sendAppOpen];
	// register for push notifications!
	[[PushNotificationManager pushManager] registerForPushNotifications];

    return YES;

3.3. Add the following code to your UIApplicationDelegate (same file as above).

// system push notification registration success callback, delegate to pushManager
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
	[[PushNotificationManager pushManager] handlePushRegistration:deviceToken];

// system push notification registration error callback, delegate to pushManager
- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error {
	[[PushNotificationManager pushManager] handlePushRegistrationFailure:error];

// system push notifications callback, delegate to pushManager
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
	[[PushNotificationManager pushManager] handlePushReceived:userInfo];

3.4. To handle push notifications add the following function to your UIApplicationDelegate (the same file as three steps above)

- (void) onPushAccepted:(PushNotificationManager *)pushManager withNotification:(NSDictionary *)pushNotification {
	NSLog(@"Push notification received");

If you would like to hide notification alerts when the app is in the foreground, simply set Pushwoosh_SHOW_ALERT value to NO in your Info.plist

That’s it! Easy, isn’t it?

For load balancing purposes we may need to change the API endpoints in your application. This happens automatically and handled by our SDK. Please make sure that nothing in your app is blocking access to any URL that contains *.pushwoosh.com in it.

NOTE: If your device is connected to the Internet via WiFi, and messages don’t get through to the device, please make sure APNs ports are not blocked by your firewall.

Push providers, iOS devices, and Mac computers are often behind firewalls. To send notifications, you will need to allow inbound and outbound TCP packets over port 2195. Devices and computers connecting to the push service over Wi-Fi will need to allow inbound and outbound TCP packets over port 5223.

The IP address range for the push service is subject to change; the expectation is that providers will connect by hostname rather than IP address. The push service uses a load balancing scheme that yields a different IP address for the same hostname. However, the entire address block is assigned to Apple, so you can specify that range in your firewall rules.

Push Notifications SDK API:

Pushwoosh https://www.pushwoosh.com/wp-content/themes/pushwoosh/img/logo.png support@pushwoosh.com