Send Advanced App Pushes

You can use this endpoint in various cases such as sending status updates of an order from your ecommerce platform or informing users of a sale on an item that was on their wishlist.

You can reach the analytics of your advanced push notifications sent via this API through Reports > Mobile App Analytics > Push API Campaigns on Inone.

The system authorizes only the 127.0.0.1 IP by default. This IP restricts the requests to the Insider APIs. To use the Mobile APIs, you must delete the default added IP or add your IPs to the IP Address Authorization list.

Endpoint and Headers

POST https://mobile.useinsider.com/api/v2/notification/user

Headers

Body Parameters

To add key-value pairs to the deep_link object, you can use the following deep link keys depending on its type:

• ins_dl_internal for an internal deep link,

• ins_dl_external for an external deep link,

• ins_dl_url_scheme for a URL scheme deep link,

• ins_dl_json for a JSON deep link.

The URL in the value should always start with https://.

Sample Body

The sample body below is for sending a carousel push notification campaign with campaign metadata, title, message, and image. It also defines an advanced push payload with multiple carousel items (each with headline, description, image, and deep links), along with platform-specific settings for Android and iOS like sound, thread ID, badges, silent delivery, and deep linking.

App push notifications are sent to a user's last active device.

{
    "api_key": "Your API Key goes here",
    "report_attributes": [
        "INSIDER.carrier",
        "INSIDER.idfa",
        "INSIDER.name",
        "INSIDER.surname",
        "INSIDER.gender",
        "INSIDER.age",
        "INSIDER.birthday",
        "INSIDER.email",
        "INSIDER.phone_number",
        "INSIDER.language",
        "INSIDER.email_optin",
        "INSIDER.sms_optin",
        "INSIDER.push_optin",
        "INSIDER.location_optin",
        "INSIDER.insider_id",
        "INSIDER.environment",
        "INSIDER.idfa",
        "INSIDER.device_token",
        "INSIDER.udid",
        "INSIDER.model",
        "INSIDER.carrier",
        "INSIDER.app_version",
        "INSIDER.os_version",
        "INSIDER.screen_width",
        "INSIDER.screen_height",
        "INSIDER.platform",
        "INSIDER.timezone",
        "INSIDER.device_language",
        "INSIDER.sdk_version",
        "INSIDER.last_ip",
        "INSIDER.package_name"
    ],
    "notifications": [
        {
            "identifiers": {
                "INSIDER.email": "example@gmail.com",
                "INSIDER.phone_number": "+9059713551597135123",
                "INSIDER.uuid": "5971351231234567"
            },
            "advanced_push_payload": {
                "advanced_push_type": "carousel",
                "advanced_push_items": [
                    {
                        "image_url": "https://your_image_url.jpg",
                        "deep_links": {
                            "your_deeplink_key": "value1"
                        },
                        "description": "Description for the item 1",
                        "headline": "Title for the item 1",
                        "id": 1
                    },
                    {
                        "image_url": "https://your_image_url.jpg",
                        "deep_links": {
                            "your_deeplink_key": "value2"
                        },
                        "description": "Description for the item 2",
                        "headline": "Title for the item 2",
                        "id": 2
                    },
                    {
                        "image_url": "https://your_image_url.jpg",
                        "deep_links": {
                            "your_deeplink_key": "value3"
                        },
                        "description": "Description for the item 3",
                        "headline": "Title for the item 3",
                        "id": 3
                    }
                ]
            },
            "camp_id": 1,
            "camp_name": "Your push notification campaign name goes here",
            "title": "Your push notification title goes here",
            "message": "Your push content goes here",
            "image_url": "https://your_image_url.jpg",
            "ttl": 1,
            "check_optin": true,
            "android": {
                "channel_id": 1,
                "sound": "sound_check",
                "deep_link": {
                    "ins_dl_internal": "https://www.deeplink.useinsider"
                }
            },
            "ios": {
                "thread-id": 13,
                "badge": 1,
                "deliver_silently": true,
                "mutable-content": true,
                "sound": "sound_check",
                "content-available": true,
                "deep_link": {
                    "ins_dl_internal": "https://www.deeplink.useinsider"
                }
            }
        }
    ]
}

Sample Responses

200 OK

{
    "successes": [
        {
            "INSIDER.carrier": "Mybrand",
            "INSIDER.device_token": "1a2b3c4d5e6f",
            "INSIDER.email": "sample@mail.com",
            "INSIDER.phone_number": "+651234567891",
        }
    },
    "errors": {
        "NoUserFound": [
            {
                "INSIDER.email": "sample2@mail.com"
            }
        ]
    }
}

There might be cases where the request returns a 200 response but the app pushes cannot be sent to users. The following list displays the reasons for these cases.

400 Bad Request

The following response returns if the payload is invalid.

{
    "error": "invalid_payload"
    "message": "Can't parse payload, check your keys and data types"
}

400 Bad Request

The following response returns if the notifications array is empty.

{
  "error": "invalid_notifications",
  "message": "'notifications' is empty, add some notification objects"
}

400 Bad Request

The following response returns if the array has more than 20 objects.

{
  "error": "invalid_notifications",
  "message": "'notifications' can't have more than 20 objects"
}

400 Bad Request

The following response returns if the deep link is blacklisted.

{
  "error": "blacklisted_deeplink",
  "message": "deepLink can't contain 'aps' key"
}

400 Bad Request

The following response returns if the camp ID or channel ID is a negative integer.

{
  "error": "negative_integer",
  "message": "camp_id' and/or 'channel_id' must be greater than zero"
}

400 Bad Request

The following response returns if the advanced push type is invalid.

{
  "error": "invalid_advanced_push_type",
  "message": "'advanced_push_type' must be either Carousel or Slider"
}

400 Bad Request

The following response returns if the certificate is invalid. Refer to Push Certificates to see how to add push certificates for iOS, Android, and Huawei.

{
  "error": "invalid_certificate",
  "message": "You do not have a validated certificate. Please check Certificate section under Insider's Settings."
}

500 Internal Server Error

Insider API services might temporarily be unavailable. Try again.

Limitations

• All functions must be executed with a simple HTTPS POST request.

• The API key should be provided in the request body. If the key is incorrect, no operation will be executed.

• The rate limit is 1000 requests per minute.

• Each request can send a maximum of 20 advanced_push_items arrays.

• For security reasons, Insider does not allow you to target more than 20 devices per target.

• You must complete the identifier integration with Insider SDK's user object for your platforms. See Android, iOS, React Native, Flutter, and Cordova for further details.

• The camp ID value should be greater than 0.

• The preferred_type value can be slider or carousel.

• The Android channel ID value should be greater than 0.