Skip to content

Use this api to trigger the outreach email in In-app referrals.

You have to send userkey or emailId or UserIdInstore in the api request to trigger outreach email.

POSTapi.appvirality.com/v2_0/invokeoutreachapplication/json

Input i.e. Request

{
"apikey":"176502556c624614b913a62400ab4d7e",
"privatekey":"8b05ee42d9c941698bbba44c00cc32d1",
"userkey": "176502556c624614b913a62400ab4d7e",
"emailId":"xxxrahulxxx@gmail.com",
"UserIdInstore":"f45d2318de"
}

Input Params

Input ParamsDescription
apikeyAPI Key of the App
Get it from DashboardApp Details
privatekeyPrivate key for API requests
Get it from: DashboardApp Details › Click App Settings › Scroll down to Advanced Settings
userkey
(conditional)
User Key for the App user - a unique identifier for every App User recorded
EmailId
(conditional)
Email of the user
UserIdInstore
(conditional)
ID of the user in your App (helps to identify users on dashboard as you do in your app)
AppUserName
(optional)
Name of the App user (is required to personalize the referral messages)
If the name consists of special characters, then send the content in URI encoded format.
ProfileImage
(optional)
User profile picture URL (required to personalize the referral messages)
city
(optional)
City of the User Location
state
(optional)
State of the User Location
country
(optional)
Country of the User Location
Phone
(optional)
User phone number (Digits only)

Response

{
"success": true,
"statuscode": 1,
"message": "Success"
}

Response Params

Output ParamsDescription
successreturns true on successful update
messageInformation regarding API call (if relevant)
status codecode based on status of the API call

Note: Once email was sent to an user through outreach, you won’t be able to trigger api for the same user in the next 90 days.

After 90 days you can trigger api for the same user so that email will be sent to that particular user

Status codes which you will see while using Invokeoutreach API

Status codes and description for API responses

Status CodeDescription
1Success
2Invalid User Key
5Invalid StoreID or EmailID
62Outreach is not configured
63User doesn’t meet Outreach Throttle criteria.
64Couldn’t schedule Outreach Notification
66No push device token for user
72No email for user