---
title: ServiceNow Joyous Integration
description: Trigger Joyous campaigns from any workflow in ServiceNow quickly and easily with the Joyous ServiceNow app.
---

[Skip to content](https://help.joyoushq.com/servicenow-integration#main-content)

[![Joyous-logo-colour](https://help.joyoushq.com/hubfs/Joyous-logo-colour.svg)](https://help.joyoushq.com/?hsLang=en)

Open main navigation

Close main navigation

- [Go to bejoyous.ai](https://bejoyous.ai/)

[Go to bejoyous.ai](https://bejoyous.ai/)

 How can we help?

- There are no suggestions because the search field is empty.

1. [Help Center](https://help.joyoushq.com/?hsLang=en)
2. [Setting up Joyous](https://help.joyoushq.com/setting-up-joyous?hsLang=en)
3. [Other Integrations](https://help.joyoushq.com/setting-up-joyous?hsLang=en#other-integrations)

# ServiceNow Joyous Integration

#### **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 and copy a **Joyous API Key** to be used by the ServiceNow integration in [**Settings \> Integrations**](https://go.joyoushq.com/configure/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\_joyou\_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 **All \> Joyous \> Configuration** and Insert the orgId copied above into the **x\_joyou\_joyous.org\_id** field and then copy the **location** from Joyous into the **x\_joyou\_joyous.region** field.
        
        **Note:** the other System Settings values on the configuration page should not need to be updated – they are set to default values on install.
3. **Assign Joyous app permissions**  
   In ServiceNow, assign x\_joyous\_admin and x\_joyous\_user to the appropriate groups or users. 
     1. x\_joyous\_admin has full access to all modules within the Joyous menu
     2. x\_joyous\_user cannot access the configuration module
4. **Activate Process Joyous Sends Queue Scheduled Job**  
     1. **In ServiceNow:** Navigate to the scheduled **script executions/scheduled jobs** (depending on your version) page in **System Definition.**
     2. Search for **Joyous Sends - Process Queue**
     3. Click on the process to edit settings, change to **active** and set the **Repeat Interval** to **once every 30 seconds
        
        Warning:** Setting your script execution to any higher frequency than once per 30 seconds may result in API calls failing due to throttling.

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 connected source to pull in contact details: 
     1. Either email or Mobile is required – you can connect one or both, but only one method will be used for sending according to the below: 
            1. If both are provided, the contact method specified in **Preferred Contact Method** will be used.
            2. If details are missing for the preferred contact method, then the alternative contact method will be used.
            3. If you do not wish for an alternative contact method to be used when the preferred method is not available, then do not connect the alternative method to a data pill
6. Save and test your flow: 
     1. You can pass the flow any valid email address, or mobile number it does not need to exist within Joyous.
7. Adding First Name/Last Name to your send: 
     1. First Name and Last Name are not required, if not sent, the recipient will be addressed as "Participant"
     2. You may send First Name only, but not Last Name only (last name will not be sent if First Name is not set)
8. Adding custom attributes to your send: Custom attributes allow you to filter conversations in Joyous and view insights for different cohorts. 
     1. Custom attributes must be configured in the [people data settings](https://go.joyoushq.com/configure/peopledata) within Joyous – if an attribute is not configured, it will still be passed, but will not show in the feed or insights until configured.

> **Note:** You must have SMS sending enabled on your Joyous account in order to send via SMS. SMS is not available on Free Trial, Basic or Plus Plans.

 

- [Setting up Joyous](https://help.joyoushq.com/setting-up-joyous?hsLang=en#main-content)

    - [Overview](https://help.joyoushq.com/setting-up-joyous?hsLang=en#overview)
    - [People data integrations](https://help.joyoushq.com/setting-up-joyous?hsLang=en#people-data-integrations)
    - [Contact methods](https://help.joyoushq.com/setting-up-joyous?hsLang=en#contact-methods)
    - [Other Integrations](https://help.joyoushq.com/setting-up-joyous?hsLang=en#other-integrations)
    - [Dashboard sign-on](https://help.joyoushq.com/setting-up-joyous?hsLang=en#dashboard-sign-on)
    - [Privacy & security](https://help.joyoushq.com/setting-up-joyous?hsLang=en#privacy-security)
    - [Matrix relationships](https://help.joyoushq.com/setting-up-joyous?hsLang=en#matrix-relationships)
    - [Resources](https://help.joyoushq.com/setting-up-joyous?hsLang=en#resources)
- [Campaign stakeholder resources](https://help.joyoushq.com/campaign-stakeholder-resources?hsLang=en#main-content)

    - [Understanding notifications](https://help.joyoushq.com/campaign-stakeholder-resources?hsLang=en#understanding-notifications)
    - [Understanding the Live Feed & Inbox](https://help.joyoushq.com/campaign-stakeholder-resources?hsLang=en#understanding-the-live-feed-inbox)
    - [Understanding filters](https://help.joyoushq.com/campaign-stakeholder-resources?hsLang=en#understanding-filters)
    - [Understanding the Dashboard](https://help.joyoushq.com/campaign-stakeholder-resources?hsLang=en#understanding-the-dashboard)
    - [Understanding the Campaign Setup](https://help.joyoushq.com/campaign-stakeholder-resources?hsLang=en#understanding-the-campaign-setup)
    - [Understanding the Board](https://help.joyoushq.com/campaign-stakeholder-resources?hsLang=en#understanding-the-board)
    - [FAQs](https://help.joyoushq.com/campaign-stakeholder-resources?hsLang=en#faqs)
- [Audience resources](https://help.joyoushq.com/audience-resources?hsLang=en#main-content)

    - [Giving feedback](https://help.joyoushq.com/audience-resources?hsLang=en#giving-feedback)
    - [Changing your feedback](https://help.joyoushq.com/audience-resources?hsLang=en#changing-your-feedback)
    - [FAQs](https://help.joyoushq.com/audience-resources?hsLang=en#faqs)
- [The HR Engagement Model](https://help.joyoushq.com/the-hr-engagement-model?hsLang=en#main-content)

    - [The Joyous HR Engagement Model](https://help.joyoushq.com/the-hr-engagement-model?hsLang=en#the-joyous-hr-engagement-model)
- [Release notes](https://help.joyoushq.com/release-notes?hsLang=en)
- [Integrations](https://help.joyoushq.com/integrations?hsLang=en#main-content)

    - [ServiceNow](https://help.joyoushq.com/integrations?hsLang=en#servicenow)

- [Joyous status](https://status.joyoushq.com/)
- [Privacy](https://www.joyoushq.com/privacy)

[![Joyous](https://help.joyoushq.com/hubfs/Joyous-logo-colour.svg "Joyous")](http://joyoushq.com)

Joyous help center

Copyright © 2025, Joyous Ltd