Getting Started with the Joyous ServiceNow App

Before you start

To use the Joyous app, you need a subscription to Joyous – you can view pricing or start a free trial here.

Initial Setup

These setup steps will need someone with ServiceNow admin privileges and someone with Joyous admin privileges.

1. Setup API Key:
   1. In Joyous: Setup a and copy a Joyous API Key to be used by the ServiceNow integration in Settings > Integrations
   2. In ServiceNow: Navigate to Connections & Credentials > Credentials then click New and select API Key Credential from the list.
   3. Name your key "Joyous API Key", or a name that matches your standard naming conventions. Paste the Joyous API Key you created in step 1 into the API key field. 
   4. Click the lock beside Credential Alias and then find record and add x_1862587_joyous.Joyous_API_Key_Alias – this step is important because it links your API Key credential to the app.
2. Add Joyous Org ID:
   
   1. In Joyous: Open any triggered campaign and view settings, copy the 
      orgId value from the snippet provided.
   2. In ServiceNow: Navigate to Joyous > Joyous Setup and Insert the orgId copied above into the x_1862587_joyous.org_id field and then copy the location from Joyous into the x_1862587_joyous.region field.

Now your Joyous app is setup, you can use the Send Joyous Campaign spoke in flow designer.

Using the Joyous Spoke in Flow Designer

1. In Joyous: Navigate to the triggered campaign you wish to send, copy the recurringCampaignGroupId value.
2. In ServiceNow: Create your workflow and add a trigger. 
3. Add an action – find the Joyous app, then select Send Joyous campaign.
4. Paste the Recurring Campaign Group ID copied above
5. Use the data pills from the trigger object or any other source to pull an email property into the email field.
6. Save and test your flow:
   1. You can pass the flow any valid email address, it does not need to exist within Joyous.