Presets API

List of methods for working with presets

createPreset

/createPreset

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

Creates a new preset.

Request Body

Name	Type	Description
auth*	string	API access token from Pushwoosh Control Panel.
name*	string	Preset name.
applicationCode*	string	Pushwoosh application code.
campaignCode	string	Code of a campaign to which you want to assign this preset.
content*	object	Message content parameters.
content.message*	string	String or array. Messages content. In case it's a string, the "Default" language will be used.
content.action	object	Custom action parameters. See the example below.
content.userData	array	Custom user data. Will be passed as "u" parameter in the payload (converted to JSON string).
content.properties	array	Specific content for different platforms. See the example below.
scheduling.sendRate	integer	Throttling. Valid values are from 100 to 1000 pushes/second.
segmentation	object	Segmentation parameters
segmentation.filter	string	Filter name
segmentation.platforms*	array	Array of integers. The list of platforms ids. 1 - iOS, 2 - BB, 3 - Android, 5 - Windows Phone, 7 - OS X, 8 - Windows 8, 9 - Amazon, 10 - Safari, 11 - Chrome, 12 - Firefox. Ignored if "devices"<10

200

{
   "status_code":200,
   "status_message":"OK"
}

Example

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // required, string. API access token from Pushwoosh Control Panel.
    "name": "PRESET_NAME", // required, string.
    "applicationCode": "XXXXX-XXXXX", // required, string. Pushwoosh application code.
    "applicationGroupCode": "AAAAA-BBBBB", // optional, string. Can be used instead of "applicationCode". 
    "campaignCode": "CCCCC-DDDDD", // optional, string. Campaign code.
    "content": { // required, object. Contains message data.
      "message": { // required, string or object. Message content. In case it's a string, the default language will be used.
        "en": "English message", // Message content localized for different languages. Only ISO 639-1:2002 for language codes.
        "fr": "French message"
      },
      "title": { // optional, string or object. For multilanguage, set title for each language in the object. Ignored if platform-specific titles are specified (e.g., 'ios_title', 'android-header', etc.; see the platform-specific parameters examples in the /createMessage API).
        "en": "English title", // Message content localized for different languages. Only ISO 639-1:2002 for language codes.
        "fr": "French title"
      },
      "subtitle": { // // optional, string or object. For multilanguage, set title for each language in the object. Ignored if platform-specific subtitles are specified (e.g., 'ios_subtitle', etc.; see the platform-specific parameters examples in the /createMessage API).
        "en": "English subtitle",
        "fr": "French subtitle"
      },
      "action": { // optional, object. Action to be performed once a user opens a message. 
        "type": "url", // optional, string. Type of action. Available types: `url`, `deepLink`, `richMedia`, `openApp`(default).
        "options": { // optional, object. Options for action types. Required for all action types except for `openApp`.
          "url": "http://example.com", // required for `url` action type, string. Will be shortened if shortener is defined.
          "shortener": 2, // optional, integer. Available values: 0 — do not minimize, 2 — bit.ly. If no shortener is specified, bit.ly shortener will be used by default.  
          "richMediaCode": "BBBBB-AAAAA", // required for `richMedia` action type, string. Rich Media code from Pushwoosh Control Panel.
          "id": 123, // required for "deepLink" action type, integer. Deep Link ID. 
          "params": { // optional, custom parameters, required for "deepLink" action type, array.
            "param1": "value1",
            "param2": "value2"
          }
        }
      },
      "userData": { // optional, object. Custom user data. Will be passed as "u" parameter in the payload (converted to JSON string).
        "CustomData": "value"
      },
      "platforms": {
        "ios": {
          "sound": "default",
          "silent": 1,
          "ttl": 604800,
          "rootParams": {
            "rule_id": "12345",
            "screen_id": "34567"
          },
          "interruptionLevel": "active"
        },
        "android": {
          "rootParams": {
            "rule_id": "12345",
            "screen_id": "34567"
          }
        }
      }
    },
    "scheduling": { // optional, object. Scheduling options.
      "sendRate": 1000 // optional, integer. Throttling. Valid values are from 100 to 1000 pushes/second.
    },
    "segmentation": { // required, object. Segmentation options.
      "filter": "FILTER NAME", // optional, string. Filter name from your Pushwoosh Control Panel.
      "platforms": [11,3] // required, array. The list of platforms IDs: 1 — iOS; 3 — Android; 7 — OS X; 8 — Windows 8; 9 — Amazon; 10 — Safari; 11 — Chrome; 12 — Firefox; ignored if "devices" < 10
    }
  }
}

For platform-specific parameters, please refer to /createMessage.

getPreset

/getPreset

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

Retrieves the parameters of the specific push preset.

Request Body

Name	Type	Description
auth*	string	API access token from Pushwoosh Control Panel.
preset_code*	string	Push preset code to retrieve information for.

200

{ 
  "status_code":200,
  "status_message":"OK",
  "response":{ 
    "preset":{ 
      "code":"XXXXX-XXXXX",
      "name":"Full preset",
      "page_id":26,
      "url":null,
      "content":{ 
        "en":"Some eng message",
        "ru":"\u041a\u0430\u043a\u043e\u0439-\u0442\u043e \u0442\u0435\u043a\u0441\u0442"
      },
      "properties":{ 
        "ignore_user_timezone":1,
        "ios_badges":"5",
        "ios_sound":"default",
        "ios_ttl":"43200",
        "android_sound":"Sound1.wav",
        "android_custom_icon":"icon.png",
        "android_header":"android_header",
        "android_gcm_ttl":"43200",
        "wns_type":"toast",
        "wns_content":{ 
          "template":"ToastImageAndText02",
          "lang-en":{ 
            "headlinetext":"Title",
            "bodytext":"super text"
          },
          "languages":["en", "zh", "it", "sv", "de", "fr", "ru", "pt", "nl", "es"],
          "lang-zh":{ 
            "headlinetext":"",
            "bodytext":""
          },
          "lang-it":{ 
            "headlinetext":"",
            "bodytext":""
          },
          "lang-sv":{ 
            "headlinetext":"",
            "bodytext":""
          },
          "lang-de":{ 
            "headlinetext":"",
            "bodytext":""
          },
          "lang-fr":{ 
            "headlinetext":"",
            "bodytext":""
          },
          "lang-ru":{ 
            "headlinetext":"",
            "bodytext":""
          },
          "lang-pt":{ 
            "headlinetext":"",
            "bodytext":""
          },
          "lang-nl":{ 
            "headlinetext":"",
            "bodytext":""
          },
          "lang-es":{ 
            "headlinetext":"",
            "bodytext":""
          },
          "imagesource":"http:\/\/image.com\/jpg"
        },
        "blackberry_header":"Some Header",
        "adm_sound":"song",
        "adm_custom_icon":"i5.bmp",
        "adm_header":"Amazon Header",
        "adm_ttl":"7200",
        "wp_type":"Tile",
        "wp_background":"i1.png",
        "wp_count":5,
        "wp_backbackground":"i2.png",
        "wp_backtitle":"back title",
        "wp_backcontent":"back content",
        "safari_title":"Safari title",
        "safari_action":"OK",
        "safari_url_args":["hello.com",  ""],
        "safari_ttl":"43200",
        "userdata":"{\"custom\":\"data\"}",
        "created_via":"CP",
        "user_id":2,
        "filter_id":"1"
      },
      "platforms":[1,3,2,5,9,4,7,8,10]
    }
  }
}

Example

    {
      "request":{
        "auth": "yxoPUlwqm…………pIyEX4H", // required, API access token from Pushwoosh Control Panel
        "preset_code": "AAAAA-BBBBB" // required, push preset code to retrieve information for    
      }
    }

listPresets

/listPresets

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

Retrieves the list of presets created for the app.

Request Body

Name	Type	Description
auth*	string	API access token from Pushwoosh Control Panel.
application*	string	Pushwoosh app code.

200

No presets

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "presets": []
  }
}

Presets list

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "presets": [
      {
        "name": "test",
        "code": "AAAAA-BBBBB"
      }
    ]
  }
}

{
 "request": {
  "auth" : "yxoPUlwqm…………pIyEX4H", // required, API access token from Pushwoosh Control Panel
  "application": "XXXXX-XXXXX" // required, Pushwoosh app code
 }
}

deletePreset

/deletePreset

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

Deletes a preset from your account.

Request Body

Name	Type	Description
auth*	string	API access token from Pushwoosh Control Panel.
preset_code*	string	Preset code retrieved from Pushwoosh Control Panel or /listPresets API response.

200

{
    "status_code": 200,
    "status_message": "OK",
    "response": null
}

Example

{
 "request": {
     "auth": "yxoPUlwqm…………pIyEX4H", // required, API access token from Pushwoosh Control Panel 
     "preset_code": "AAAAA-BBBBB" // required, code of a preset to delete 
    } 
}