Push to All

This API can be used to send notifications to all subscribers of your website.

Notification Payload Example

curl -X POST \
 - H "Authentication-Token: {API_TOKEN}" \
 - H "Content-Type: application/json" \
 -d '{
 "campaign_name" : "{CAMPAIGN_NAME}",
 "title" : "{NOTIFICATION_TITLE}",
 "message" : "{NOTIFICATION_MESSAGE}",
 "icon_url" : "{ICON_URL}",
 "badge_icon_url" : "{BADGE_ICON_URL}",
 "banner_url" : "{BANNER_URL}",
 "landing_url" : "{LANDING_URL}",
 "actions" : [
 {
 "text" : "{BUTTON_1_TEXT}",
 "url" : "{BUTTON_1_URL}",
 "icon" : "{BUTTON_1_ICON}"
 },
 {
 "text" : "{BUTTON_2_TEXT}",
 "url" : "{BUTTON_2_URL}",
 "icon" : "{BUTTON_2_ICON}"
 }],
 "utm_source" : "{UTM_SOURCE}",
 "utm_medium" : "{UTM_MEDIUM}",
 "utm_campaign" : "{UTM_CAMPAIGN}",
 "req_interaction" : {true/false},
 "override_tag" : "{CAMPAIGN_TAG_NAME}",
 "ttl" : {TTL_SECONDS},
 "target" : {
 "type" : "all"
 }
 }' "https://apis.izooto.com/v1/notifications"
curl --request POST \
     --url https://apis.izooto.com/v1/notifications \
     --header 'Authentication-Token:YOUR_REST_API_KEY' \
     --header 'content-type: application/json' \
     --data '{
     "campaign_name" : "{CAMPAIGN_NAME}",
     "title" : "{NOTIFICATION_TITLE}",
     "message" : "{NOTIFICATION_MESSAGE}",
     "icon_url" : "{ICON_URL}",
     "badge_icon_url" : "{BADGE_ICON_URL}",
     "banner_url" : "{BANNER_URL}",
     "landing_url" : "{LANDING_URL}",
     "actions" : [
     {
     "text" : "{BUTTON_1_TEXT}",
     "url" : "{BUTTON_1_URL}",
     "id":"{BUTTON_1_ACTION_ID}"
     },
     {
      "text" : "{BUTTON_2_TEXT}",
      "url" : "{BUTTON_2_URL}",
      "id":"{BUTTON_2_ACTION_ID}"
      }
      ],
      "utm_source" : "{UTM_SOURCE}",
      "utm_medium" : "{UTM_MEDIUM}",
      "utm_campaign" : "{UTM_CAMPAIGN}",
      "ttl" : {TTL_SECONDS},
      "override_tag" : "{OVERRIDE_TAG}",
      "target" : {
      "type" : "all"
      },
      "additional_params":{
      "{KEY_1}":"{VALUE_1}",
      "{KEY_2}":"{VALUE_2}",
      "{KEY_3}":"{VALUE_3}",
      "{KEY_4}":"{VALUE_4}",
      "{KEY_5}":"{VALUE_5}"
      },
      "open_in_app" :{TRUE/FALSE}
      }
curl --request POST \
     --url https://apis.izooto.com/v1/notifications \
     --header 'Authentication-Token:YOUR_REST_API_KEY' \
     --header 'content-type: application/json' \
     --data '{
     "campaign_name" : "{CAMPAIGN_NAME}",
     "title" : "{NOTIFICATION_TITLE}",
     "message" : "{NOTIFICATION_MESSAGE}",
     "icon_url" : "{ICON_URL}",
     "badge_icon_url" : "{BADGE_ICON_URL}",
     "banner_url" : "{BANNER_URL}",
     "landing_url" : "{LANDING_URL}",
     "actions" : [
     {
     "text" : "{BUTTON_1_TEXT}",
     "url" : "{BUTTON_1_URL}",
     "id":"{BUTTON_1_ACTION_ID}"
     },
     {
      "text" : "{BUTTON_2_TEXT}",
      "url" : "{BUTTON_2_URL}",
      "id":"{BUTTON_2_ACTION_ID}"
      }
      ],
      "utm_source" : "{UTM_SOURCE}",
      "utm_medium" : "{UTM_MEDIUM}",
      "utm_campaign" : "{UTM_CAMPAIGN}",
      "ttl" : {TTL_SECONDS},
      "override_tag" : "{OVERRIDE_TAG}",
      "target" : {
      "type" : "all"
      },
      "additional_params":{
      "{KEY_1}":"{VALUE_1}",
      "{KEY_2}":"{VALUE_2}",
      "{KEY_3}":"{VALUE_3}",
      "{KEY_4}":"{VALUE_4}",
      "{KEY_5}":"{VALUE_5}"
      },
      "open_in_app" :{TRUE/FALSE}
      }

🚧

Fixed Values for UTM Parameters!

The values for utm_source and utm_medium is set to izooto and push_notifications respectively, by default, for both web and app push. This cannot be changed. If you use a different value in your payload, it will be ignored and the default values will be used.

Parameters Definition

NameDescriptionTypeRequiredSupported On
Authentication-tokenAPI token for your siteStringYes-
Campaign NameCampaign TitleStringYesWeb Push:
Chrome, Firefox, Safari, Opera and Edge

App Push:
Android
TitileNotification TitleStringYesWeb Push:
Chrome,
Firefox,
Safari,
Opera and
Edge

App Push:
Android
MessageMessage on NotificationStringYesWeb Push:
Chrome,
Firefox,
Safari,
Opera and
Edge

App Push:
Android
Icon UploadFile Size <= 20kb
(Dimensions: 100 X 100)
JPG, JPEG, PNG formats only.

Note: Safari uses a default bell Icon
YesWeb Push:
Chrome 50+,
Firefox 44+,
Opera 42+,
Edge 17+
icon_url
Only applicable for Web and Android Push
Notification icon URL
(HTTPS URL Only)
(Dimensions: 100 X 100)
StringYesWeb Push:
Chrome 50+,
Firefox 44+,
Opera 42+,
Edge 17+

App Push:
Android
badge_icon_url
Only applicable for Web and Android Push
Badge icon URL
File Size <= 20kb
(HTTPS URL Only)
(Dimensions: 72 X 72)
String
PNG formats only
NoWeb Push:
Chrome 50+,
Firefox 44+,
Opera 42+,
Edge 17+

App Push:
Android
banner_urlURL of banner image
(HTTPS)
File Size<=100Kb
(Dimensions: 360 X 240 for Desktop and 360 X 200 for Mobile)
String
Jpg, Jpeg, Png formats only
NoWeb Push:
Chrome 50+,
Opera 42+,
Edge 17+

App Push:
Android
landing_urlLanding Page URLStringYesWeb Push:
Chrome,
Firefox,
Safari,
Opera and
Edge

App Push:
Android
actions > textButton TextStringNoWeb Push:
Chrome 56+,
Opera 57+,
Edge 17+

App Push:
Android
actions > urlButton Landing URLStringNoWeb Push:
Chrome 56+,
Opera 57+,
Edge 17+

App Push:
Android
actions > icon
Only applicable for Web and Android Push
Button Icon URL
File Size <= 20kb
(HTTPS URL Only)
(Dimensions: 24 X 24)
String
Jpg, Jpeg, Png formats only
NoWeb Push:
Chrome 56+,
Opera 57+,
Edge 17+

App Push:
Android
actions > idButton Action IDStringNoApp Push:
Android
utm_source
(value set to izooto; cannot be changed)
UTM SourceStringNoWeb Push:
Chrome,
Firefox,
Safari,
Opera,
Edge

App Push:
Android
utm_medium
(value set to push_notifications; cannot be changed)
UTM MediumStringNoWeb Push:
Chrome,
Firefox,
Safari,
Opera,
Edge

App Push:
Android
utm_campaignUTM CampaignStringNoWeb Push:
Chrome,
Firefox,
Safari,
Opera,
Edge

App Push:
Android
req_interactionMake Notifications StickyBooleanNoWeb Push:
Chrome
override_tagShow Latest Campaign TagString
(Max 15 characters)
NoWeb Push:
Chrome
ttl (time-to -live)Notification expiry timeNumeric (seconds)NoWeb Push:
Chrome,
Firefox,
Opera,

App Push:
Android
target > typeNotification Audience.
Use "Topic" for Android.
StringYesWeb Push:
Chrome,
Firefox,
Opera,

App Push:
Android
additional_paramsCustom Key-Value pairs used to open native screens inside appStringNoApp Push:
Android


Sample Code

curl -X POST \        
 - H "Authentication-Token: abc123efgh456ijklmn9786" \
 - H "Content-Type: application/json" \
 -d '{
 "campaign_name" : "Test Campaign"
 "title" : "Limited Period Offer",
 "message" : "Go Shopping, Save Big",
 "icon_url" : "https://yourdomain.com/icon.png",
 "badge_icon_url" : "https://yourdomain.com/badge_icon.png",
 "banner_url" : "https://yourdomain.com/large-image.png",
 "landing_url" : "https://yourdomain.com/offers",
 "actions" : [
 {
 "text" : "Buy Now",
 "url" : "https://yourdomain.com/buy-now",
 "icon" : "https://yourdomain.com/button_1_icon.png"
 },
 {
 "text" : "Compare",
 "url" : "https://yourdomain.com/compare",
 "icon" : "https://yourdomain.com/button_2_icon.png"
 }],
 "utm_source" : "izooto",
 "utm_medium" : "push_notifications",
 "utm_campaign" : "promotion",
 "req_interaction" : true,
 "override_tag" : "My Tag",
 "ttl" : 86400,
 "target" : {
 "type" : "all"
 }
 }' "https://apis.izooto.com/v1/notifications"
curl --request POST \
     --url https://apis.izooto.com/v1/notifications \
     --header 'Authentication-Token:YOUR_REST_API_KEY' \
     --header 'content-type: application/json' \
     --data  '{
     "campaign_name" : "Test Campaign"
     "title" : "Limited Period Offer",
     "message" : "Go Shopping, Save Big",
     "icon_url" : "https://yourdomain.com/icon.png",
     "badge_icon_url" : "https://yourdomain.com/badge_icon.png",
     "banner_url" : "https://yourdomain.com/large-image.png",
     "landing_url" : "https://yourdomain.com/offers",
     "actions" : [
     {
     "text" : "Read More",
     "url" : "https://yourdomain.com/world-news",
     "id":"Launch_Activity"
     },
     {
     "text" : "Local News",
     "url" : "https://yourdomain.com/local-news",
     "id":"Launch_Activity"
     }
     ],
     "utm_source" : "izooto",
     "utm_medium" : "push_notifications",
     "utm_campaign" : "promotion",
     "ttl" : 86400,
     "override_tag" : "Test_Tag",
     "target" : {
     "type" : "all"
     },
     "additional_params":{
     "News_Activity":"87162",
     "Home_Activity":"Home",
     "Video_Activity":"aksjdhakjdh",
     "ID":"1923879",
     "Live_TV":"1982312938"
     },
     "open_in_app" :true
     }'
curl --request POST \
     --url https://apis.izooto.com/v1/notifications \
     --header 'Authentication-Token:YOUR_REST_API_KEY' \
     --header 'content-type: application/json' \
     --data  '{
     "campaign_name" : "Test Campaign"
     "title" : "Limited Period Offer",
     "message" : "Go Shopping, Save Big",
     "icon_url" : "https://yourdomain.com/icon.png",
     "badge_icon_url" : "https://yourdomain.com/badge_icon.png",
     "banner_url" : "https://yourdomain.com/large-image.png",
     "landing_url" : "https://yourdomain.com/offers",
     "actions" : [
     {
     "text" : "Read More",
     "url" : "https://yourdomain.com/world-news",
     "id":"Launch_Activity"
     },
     {
     "text" : "Local News",
     "url" : "https://yourdomain.com/local-news",
     "id":"Launch_Activity"
     }
     ],
     "utm_source" : "izooto",
     "utm_medium" : "push_notifications",
     "utm_campaign" : "promotion",
     "ttl" : 86400,
     "override_tag" : "Test_Tag",
     "target" : {
     "type" : "all"
     },
     "additional_params":{
     "News_Activity":"87162",
     "Home_Activity":"Home",
     "Video_Activity":"aksjdhakjdh",
     "ID":"1923879",
     "Live_TV":"1982312938"
     },
     "open_in_app" :true
     }'