App Configuration API

API methods to configure app platforms

configureApplication for iOS

Configures iOS platform for the app.

POST https://api.pushwoosh.com/json/1.3/configureApplication

Configures iOS platform for the app.

Request Body

NameTypeDescription

auth

string

API access token from Pushwoosh Control Panel.

application

string

Pushwoosh application code.

device_type

integer

Must be 1 for iOS.

ios_key_management_type

string

"manual" (one step) or "auto" (few steps).

ios_key_file

string

Base64-encoded iOS key file content.

ios_key_password

string

Password for iOS key file.

ios_gateway

string

"0" for sandbox, "1" for production.

ios_framework

string

Possible values: "native", "cordova", "titanium"

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": true,
      "android": false,
      "wp7": false,
      "macos": false,
      "blackberry": false,
      "wns": false,
      "adm": false,
      "safari": false
    }
  }
}

For Custom Plan subscriptions only. For more details, please contact our Sales team.

Example
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H", // required, API access token from Pushwoosh Control Panel
    "application": "XXXXX-XXXXX", // required, Pushwoosh application code
    "device_type": 1, // required, 1 - ios, 3 - android, 7 - osx, 8 - windows, 9 - amazon, 10 - safari
    "ios_key_management_type": "manual", // required, "manual" (one step) | "auto" (few steps)
    "ios_key_file": "MIIMY...BAQ==", // required, base64-encoded iOS key file content
    "ios_key_password": "password", // required
    "ios_gateway": "1", // required, "0" (sandbox) | "1" (production)
    "ios_framework": "native" // required, possible values: "native", "cordova", "titanium", "marmalade", "adobeAir", "corona", "xamarin", "phoneGapBuild", "triggerIO", "unity"
  }
}

Auto configuration

Step 1 Create an app and provide your Apple ID information.

{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H", // API access token from Pushwoosh Control Panel
    "application": "XXXXX-XXXXX", // Pushwoosh application code
    "device_type": 1,
    "ios_key_management_type": "auto",
    "step": "1",
    "ios_apple_id": "xxx@xxxxx.xxx",
    "ios_apple_password": "xxxxxx",
    "ios_framework": "native" // possible values: "native", "cordova", "titanium", "marmalade", "adobeAir", "corona", "xamarin", "phoneGapBuild", "triggerIO", "unity"
  }
}

Step 2 Select the Team ID.

{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H", // API access token from Pushwoosh Control Panel
    "application": "XXXXX-XXXXX", // Pushwoosh application code
    "device_type": 1,
    "ios_key_management_type": "auto",
    "step": "2",
    "ios_apple_id": "xxx@xxxxx.xxx",
    "ios_apple_password": "xxxxxx",
    "ios_framework": "native", // possible values: "native", "cordova", "titanium", "marmalade", "adobeAir", "corona", "xamarin", "phoneGapBuild", "triggerIO", "unity"
    "team_id":"12345ABCDE"
 }
}

Step 3 Select the App Id.

{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H", // API access token from Pushwoosh Control Panel
    "application": "XXXXX-XXXXX", // Pushwoosh application code
    "device_type": 1,
    "ios_key_management_type": "auto",
    "step": "3",
    "ios_apple_id": "xxx@xxxxx.xxx",
    "ios_apple_password": "xxxxxx",
    "ios_framework": "native", // possible values: "native", "cordova", "titanium", "marmalade", "adobeAir", "corona", "xamarin", "phoneGapBuild", "triggerIO", "unity"
    "team_id": "12345ABCDE",
    "appid": "67890FGHIJ"
 }
}

Step 4 Select the apns_type. Configure the app for Dev or Prod.

{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H", // API access token from Pushwoosh Control Panel
    "application": "XXXXX-XXXXX", // Pushwoosh application code
    "device_type": 1,
    "ios_key_management_type": "auto",
    "step": "4",
    "ios_apple_id": "xxx@xxxxx.xxx",
    "ios_apple_password": "xxxxxx",
    "ios_framework": "native", // possible values: "native", "cordova", "titanium", "marmalade", "adobeAir", "corona", "xamarin", "phoneGapBuild", "triggerIO", "unity"
    "team_id": "12345ABCDE",
    "appid": "67890FGHIJ",
    "apns_type": "0" // "0" - configure certificate for Development | "1" - configure certificate for Production
 }
}

Step 5 Select the certificate and provisioning profile.

{
  "request":{
    "auth":"API_ACCESS_TOKEN",
    "application":"APPLICATION_CODE",
    "device_type":"1",
    "ios_key_management_type":"auto",
    "step":"5",
    "ios_apple_id":"xxx@xxxxx.xxx",
    "ios_apple_password":"xxxxxx",
    "ios_framework": "native", // one of native, cordova, titanium, marmalade, adobeAir, corona, xamarin, phoneGapBuild, triggerIO, unity
    "team_id":"12345ABCDE",
    "appid":"67890FGHIJ",
    "apns_type": "0",
    "auto_update_profile": "1", // "0" - manual profile update | "1" - auto profile update
    "profile": "KLMNOPQRS2",
    "certificate" : "PY986727N9"
  }
}

configureApplication for Android

Configures Android platform for the app.

POST https://api.pushwoosh.com/json/1.3/configureApplication

Configures Android platform for the app.

Request Body

NameTypeDescription

auth*

string

API access token from your Pushwoosh Control Panel.

application*

string

Pushwoosh application code.

device_type*

integer

Must be 3 for Android.

android_gcm_api_key*

string

Android GCM/FCM API Key obtained from Firebase project settings.

android_gcm_sender_id*

string

Android GCM/FCM Sender ID obtained from Firebase project settings.

android_framework*

string

Android framework. Possible values: native, cordova, marmalade, adobeAir, corona, xamarin, phoneGapBuild, triggerIO, titanium, unity.

android_fcm_service_account*

string

FCM service account key (JSON file generated in Firebase project settings).

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": true,
      "android": true,
      "wp7": false,
      "macos": false,
      "blackberry": false,
      "wns": false,
      "adm": false,
      "safari": false
    }
  }
}

For Custom Plan subscriptions only. For more details, please contact our Sales team.

{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H", // required, API access token from Pushwoosh Control Panel
    "application": "XXXXX-XXXXX", // required, Pushwoosh application code
    "device_type": 3, // required, 3 for Android device type
    "android_fcm_service_account": "FCM service account key", // required, JSON file generated in Firebase project settings
    "android_gcm_api_key": "AIzaSyA…………….7rM", // required, Android GCM/FCM API Key
    "android_gcm_sender_id": "4821……4542", // required, Android GCM/FCM Sender ID
    "android_framework": "native" // required, possible values: native, cordova, marmalade, adobeAir, corona, xamarin, phoneGapBuild, triggerIO, titanium, unity
  }
}

configureApplication for Mac OS X

Configures Mac OS X platform for the app.

POST https://api.pushwoosh.com/json/1.3/configureApplication

Configures Mac OS X platform for the app.

Request Body

NameTypeDescription

auth*

string

API access token from Pushwoosh Control Panel.

application*

string

Pushwoosh application code.

device_type*

integer

Must be 7 for Mac OS X.

macos_key_management_type*

string

Only "manual" type is available currently.

macos_cert_file

string

Base64-encoded Mac OS X certificate file content.

macos_key_file

string

Base64-encoded Mac OS X key file content.

macos_key_password

string

Key file password.

macos_gateway*

integer

Push gateway. "0" for sandbox, "1" for production.

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": true,
      "android": true,
      "wp7": true,
      "macos": true,
      "blackberry": false,
      "wns": false,
      "adm": false,
      "safari": false
    }
  }
}

For Custom Plan subscriptions only. For more details, please contact our Sales team.

Example
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H", // required, API access token from Pushwoosh Control Panel
    "application": "XXXXX-XXXXX", // required, Pushwoosh application code
    "device_type": 7, // 7 for OS X
    "macos_key_management_type": "manual", // required, only "manual" available 
    "macos_cert_file": "iVBORw0KGgoAAAANSUhEUgAABB…", // optional. Base64-encoded content of Mac OS X certificate file 
    "macos_key_file": "iVBORw0KGgoAAAANSUhEUgAABB…", // optional. Base64-encoded content of Mac OS X key file 
    "macos_key_password": "PASSWORD", // optional. Key file password 
    "macos_gateway": 1 // required, push gateway. "0" for sandbox or "1" for production 
  }
}

configureApplication for Windows 8

Configures Windows 8 platforms for the app.

POST https://api.pushwoosh.com/json/1.3/configureApplication

Configures Windows 8 platforms for the app.

Request Body

NameTypeDescription

auth*

string

API access token from Pushwoosh Control Panel.

application*

string

Pushwoosh application code.

device_type*

integer

Must be 8 for Windows.

wns_psid*

string

Package security identifier from Windows Store for the app. Starts with "ms-app://".

wns_secret*

string

Client Secret from Windows Store for the app.

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": true,
      "android": true,
      "wp7": true,
      "macos": true,
      "blackberry": true,
      "wns": true,
      "adm": false,
      "safari": false
    }
  }
}

For Custom Plan subscriptions only. For more details, please contact our Sales team.

Example
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H", // required, API access token from Pushwoosh Control Panel
    "application": "XXXXX-XXXXX", // required, Pushwoosh application code
    "device_type": 8, // 8 for Windows 8
    "wns_psid": "ms-app://…", // required, package security identifier of the app from Windows Store
    "wns_secret": "CLIENT_SECRET" // required, Windows client secret 
  }
}

configureApplication for Amazon

Configures Amazon platform for the app.

POST https://api.pushwoosh.com/json/1.3/configureApplication

Configures Amazon platform for the app.

Request Body

NameTypeDescription

auth*

string

API access token from Pushwoosh Control Panel.

application*

string

Pushwoosh application code.

device_type*

integer

Must be 9 for Amazon.

adm_cid*

string

Amazon client ID.

adm_secret*

string

Amazon client secret.

adm_framework*

string

Amazon framework. Possible values: native, unity, adobeAir.

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": true,
      "android": true,
      "wp7": true,
      "macos": true,
      "blackberry": true,
      "wns": true,
      "adm": true,
      "safari": false
    }
  }
}

For Custom Plan subscriptions only. For more details, please contact our Sales team.

Example
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H", // required, API access token from Pushwoosh Control Panel
    "application": "XXXXX-XXXXX", // required, Pushwoosh application code
    "device_type": 9, // required, 9 for Amazon
    "adm_cid": "CLIENT_ID", // required, Amazon client ID
    "adm_secret": "CLIENT_SECRET", // required, Amazon Client Secret  
    "adm_framework": "native" // required, possible values: native, unity, adobeAir. 
  }
}

configureApplication for Chrome

Configures Chrome platform for the app.

POST https://api.pushwoosh.com/json/1.3/configureApplication

Configures Chrome platform for the app.

Request Body

NameTypeDescription

auth*

string

API access token from Pushwoosh Control Panel.

application*

string

Pushwoosh application code.

device_type*

integer

Must be 11 for Chrome.

chrome_gcm_api_key*

string

GCM/FCM API key for Google Chrome.

chrome_gcm_project_number*

string

GCM/FCM Project number.

chrome_fcm_service_account*

string

FCM service account key (JSON file generated in Firebase project settings).

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": false,
      "android": true,
      "wp7": false,
      "macos": false,
      "blackberry": false,
      "wns": false,
      "adm": false,
      "safari": false,
      "asha": false,
      "chrome": true
    }
  }
}

For Custom Plan subscriptions only. For more details, please contact our Sales team.

{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H", // required, API access token from Pushwoosh Control Panel
    "application": "XXXXX-XXXXX", // required, Pushwoosh application code
    "device_type": 11, // required, 11 for Chrome
    "chrome_fcm_service_account": "FCM service account key", // required, JSON file generated in Firebase project settings
    "chrome_gcm_api_key": "AIzaSyA…………….7rM", // required, GCM/FCM API key for Google Chrome 
    "chrome_gcm_project_number": "557…919" // required, GCM/FCM project number 
  }
}

configureApplication for Safari

Configures Safari platform for the app.

POST https://api.pushwoosh.com/json/1.3/configureApplication

Configures Safari platform for the app.

Request Body

NameTypeDescription

auth*

string

API access token from Pushwoosh Control Panel.

application*

string

Pushwoosh application code.

device_type*

integer

Must be 10 for Safari.

safari_key_management_type*

string

Only "manual" type is available currently.

safari_website_name

string

Website name.

safari_allowed_domains

array

Ex: [http://site1.com/", https://site2.com"]

safari_url_template*

string

Safari URL template formatted as "https://%@".

safari_icon_file

string

Base64-encoded content of 256x256px png file.

safari_key_file*

string

Base64-encoded Safari .p12 key file content.

safari_key_password

string

Password to the key file.

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": false,
      "android": false,
      "wp7": false,
      "macos": false,
      "blackberry": false,
      "wns": false,
      "adm": false,
      "safari": true
    }
  }
}

For Custom Plan subscriptions only. For more details, please contact our Sales team.

Example
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H", // required, API access token from Pushwoosh Control Panel
    "application": "XXXXX-XXXXX", // required, Pushwoosh application code
    "device_type": 10, // required, 10 for Safari
    "safari_key_management_type": "manual", // required, only "manual" available
    "safari_website_name": "WEBSITE_NAME", // optional 
    "safari_allowed_domains": ["http://site1.com", "https://site2.com"], // optional
    "safari_url_template": "https://%@", // required
    "safari_icon_file": "iVBORw0KGgoAAAANSUhEUgAABB…", // optional. Base64-encoded content of 256x256px png file
    "safari_key_file": "MIIMY...BAQ==", // required, base64-encoded Safari .p12 key file content  
    "safari_key_password": "PASSWORD" // optional. Password to the key file above  
  }
}

configureApplication for Firefox

Configures Firefox platform for the app.

POST https://api.pushwoosh.com/json/1.3/configureApplication

Configures Firefox platform for the app.

Request Body

NameTypeDescription

auth*

string

API access token from Pushwoosh Control Panel.

application*

string

Pushwoosh application code.

device_type*

integer

Must be 12 for Firefox.

firefox_is_enabled

boolean

Enables push notifications for Firefox.

fcm_sender_id

string

GCM/FCM Sender ID for Firefox.

fcm_api_key

string

GCM/FCM API Key for Firefox.

firefox_fcm_service_account*

object

JSON generated in Firebase project settings.

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": false,
      "android": true,
      "wp7": false,
      "macos": false,
      "blackberry": false,
      "wns": false,
      "adm": false,
      "safari": false,
      "asha": false,
      "firefox": true
    }
  }
}

For Custom Plan subscriptions only. For more details, please contact our Sales team.

{
  "request":{
    "auth": "lZcoO8ZDvg8nIVh6kS6LWHwcRCS13KxarteY41Alv+a96CKEK+CTUwLszZMbWeuYdTC8KgxphbtAHZ6RQ153", // required, API access code from Pushwoosh Control Panel
    "application": "1DC69-73EDB", // required, Pushwoosh application code
    "device_type": "12", // required, 12 for Firefox
    "firefox_is_enabled": true, // optional
    "firefox_fcm_service_account": "FCM service account key", // required, JSON file generated in Firebase project settings
    "firefox_fcm_sender_id": "123123123", // optional for fastpushes
    "firefox_fcm_api_key" : "sdfsdfsfsddfdsf" // optional for fastpushes
  }
}

configureApplication for Email

Configures Email platform for the app.

POST https://api.pushwoosh.com/json/1.3/configureApplication

Configures Email platform for the app.

Request Body

NameTypeDescription

auth*

string

API access token from Pushwoosh Control Panel.

application*

string

Pushwoosh application code.

device_type*

integer

Must be 14 for Email.

email_from_email*

string

Sender email address. Should be valid and verified.

email_from_name*

string

Sender name.

email_reply*

string

Email address to reply to. Should be valid and verified.

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": false,
      "android": false,
      "wp7": false,
      "macos": false,
      "blackberry": false,
      "wns": false,
      "adm": false,
      "safari": false,
      "email": true
    }
  }
}

For Custom Plan subscriptions only. For more details, please contact our Sales team.

Example
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H", // required, API access token from Pushwoosh Control Panel
    "application": "XXXXX-XXXXX", // required, Pushwoosh application code
    "device_type": 14, // 14 for email
    "email_from_email": "email@domain.com", // required, email address should be valid and verified
    "email_from_name": "SENDER_NAME", // required, name to display in the "From" email field
    "email_reply": "email@domain.com" // required, email address to reply should be valid and verified
  }
}

Last updated