Storyly is the user engagement platform to embed Stories. Storyly empowers the marketing strategies of mobile brands by enabling them to engage with their audience beyond the limits of the mobile screen and create engaging experiences without any development efforts after integration.

MoEngage <> Storyly

MoEngage <> Storyly integration allows you to
1. Send Storyly audiences to MoEngage using Storyly's Create Audiences
2. Send MoEngage segments to Storyly using MoEngage's Custom destinations 




  • Ensure you have a Storyly account.
  • You have to have your custom parameter setup between Storyly SDK & your app. Learn more.
  • Ensure that Custom destinations is enabled for your MoEngage account 

Sync Storyly's audiences to MoEngage 

Step 1: Setup MoEngage on Storyly

Let's start with connecting MoEngage account on Storyly Dashboard.

  1. On your Storyly Dashboard, go to Settings and find Integrations tab.
  2. Under Integrations, you'll see MoEngage. Please click on Connect.


When you click on Connect, you'll be asked to fill 3 fields which are:

Field Name Description
Integration Name

You may have more than 1 integration, that's why you can give any name to Integration as you want, to differentiate one from another.


API ID is the App ID.

The App ID of your MoEngage account is available in the following navigations in the revamped and old UIs:

  1. Revamped UI:  Settings -> Account -> APIs -> App ID.
  2. Old UI: You can find this by navigating to Settings -> App Settings -> APIs -> Data API Settings.

The Data API ID and the App ID of your MoEngage account are the same.


The Data API key of your MoEngage account is available in the following navigations in the revamped and old UIs:

  1. Revamped UI:  Settings -> App Settings -> APIs -> API Keys -> Data
  2. Old UI: You can find this by navigating to Settings -> App Settings -> APIs -> Data API Settings.


  1. Copy DATA API ID and DATA API Key, then paste them in the corresponding fields on the Storyly Dashboard.


  1. Once you click on Connect MoEngage, integration is completed!


From here, as referenced above, if you've created audiences from the outcome of interactive components in Storyly, you'll have an option to Export these Audiences to MoEngage.

Step 2: Send audiences to MoEngage

  1. Under Settings > Data Management > Audiences, you can see audiences that you've created. If you click on Export button, you'll see Send to MoEngage option.


  1. When you click on Send to MoEngage, you'll be asked to choose which integration that you'd like to use and to give a Key Title for the Custom Attribute that you'll see on MoEngage.
  2. After you click on Start Process, depending on the audience' size, it'll take couple of minutes for process to be completed.


Step 3: Create custom segments from Storyly Audiences

  1. Once the process is completed, you can go to MoEngage Dashboard, navigate to Segments from the left pane and click on Create Segment option.

  2. In that screen, please click on User Property and scroll down to find the custom attribute that you've exported from Storyly under Tracked Custom Attribute section.


  1. After selecting the custom attribute, if you go with the "is" and type in the name of your Audience on Storyly Dashboard, you'll be able to create a segment that includes all of the users in that Audience.

Sync MoEngage segments to Storyly 

Step 1: Create new audience for MoEngage 

  1. Go to Audiences tab on Storyly Dashboard and click on + New Audience at the top right. Select the Create Audience for MoEngage option. You can give a name to your Audience and click on Continue.Screenshot_2023-04-14_at_12.48.24_PM.png
  2. Storyly will generate a Key and unique Token as Value for your Audience. Please copy these values, and you'll paste them on the MoEngage Dashboard while configuring the integration.

Step 2: Setup custom destination on MoEngage

  1. Navigate to App Marketplace >> Custom DestinationsScreenshot_2023-04-14_at_12.43.35_PM.png

  2. Click Add Custom Destination. 
  3. Add Destination name as Storyly and description (optional). Screenshot_2023-04-14_at_12.44.25_PM.png
  4. Navigate to Integrate tab and click Add Integration Screenshot_2023-04-14_at_12.45.29_PM.png
  5. Now go back to the MoEngage Dashboard, and fill in the following details: 

    • Integration name: you can give any name you'd like.
    • Method: Choose POST option.
    • URL endpoint: Enter the endpoint:
    • Parameters: Click on +KV pair and paste the KeyValue that you've copied from the Storyly Dashboard in the previous step.
    • User identifier: Choose the identifier that you already pass to Storyly via Custom Parameter, which can be ID, e-mail, etc. Then enter identity in the Destination identifier field.Screenshot_2023-04-14_at_12.52.14_PM.png
  6. Click Next. You will now get an option to test the integration. You can enter a User value and click Test button. If the test is successful, you'll see the success message.
  7. You can also choose to skip the test by directly clicking Add Integration.Screenshot_2023-04-14_at_12.55.12_PM.png


    Step 3: Send segment to Storyly  

    1. Navigate to the Segment, click on three dots right next to the segment that you'd like to Import, and select the Sync Segment option. Screenshot_2023-04-14_at_1.11.57_PM.png

    2. Select the Destination as the Custom Destination that you've set up. Screenshot_2023-04-14_at_1.12.06_PM.png

    3. Select your Sync Frequency and other related details.

    4. Click on Save Sync.

      After this point, your MoEngage Segment will be synced to the Storyly Audience. You can view all your synced segments under the Synced Segments tab. Screenshot_2023-04-14_at_1.10.58_PM.pngScreenshot_2023-04-14_at_1.11.07_PM.png




Was this article helpful?
0 out of 0 found this helpful

How can we improve this article?