--- title: "One Step Involve Setup" canonical: "https://resources.pathify.com/space/RL/265617479/One%20Step%20Involve%20Setup" format: markdown --- > ℹ️ # At a Glance > ℹ️ > ℹ️ - The **One Step Involve Setup** Recipe replicates *Organizations* to Campus Experience Hub. > ℹ️ #### View this page on **[Pathify Resource Center](https://resources.pathify.com/space/RL/265617479/One+Step+Involve+Setup)**. ## General Details ### Description By invoking Involve’s API, the **One Step Involve Setup** Recipe replicates *[Organizations](https://involve-support.moderncampus.com/hc/en-us/articles/16515593751181-What-s-An-Organization)* to Campus Experience Hub, where they present as *[Pathify Groups](https://resources.pathify.com/space/GEAC/55280600/Groups)*. These Groups encompass everything that Organizations do, including Events and membership rosters — just in a way that’s native to Pathify instead. Here, we’ve compiled a reference to this Recipe’s technical details: --- --- > Macro (toc) --- ## Prerequisites You must fulfill the following prerequisites before installing this Recipe. ### Involve Root URL Identify the root URL (scheme and hostname) of your Involve instance. For example: `https://external-api.presence.io` --- ### Authentication This Recipe authenticates to Involve* *as a **registered application**. Gather this information about your application: > ℹ️ Contact Involve support at [presence-support@moderncampus.com](mailto:presence-support@moderncampus.com) for these values. | | | | --- | --- | | **Client ID** | Your application’s client ID. | | **Client Secret** | Your application’s client secret. | | **Involve Campus URI** | Your application’s campus URI. | | **Token Endpoint** | Your application’s token endpoint. | --- ## Installation Parameters The tables in this section detail all of the parameters that you will define while installing this Recipe. ### Main Configuration | **Parameter Name** | **Parameter Type** | **Description** | **Example** | | --- | --- | --- | --- | | Project Name | String | A string that will be prepended to any FLOW artifacts created by this Recipe. | `v1` | | Client ID | String | Your [client ID](https://resources.pathify.com/space/RL/265617479/One+Step+Involve+Setup#Authentication). | `pathify` | | Client Secret | String | Your [client secret](https://resources.pathify.com/space/RL/265617479/One+Step+Involve+Setup#Authentication). | N/A | | Campus URI | String | Your [campus URI](https://resources.pathify.com/space/RL/265617479/One+Step+Involve+Setup#Authentication). | `pathifyu` | | Token Endpoint | String | Your [token endpoint](https://resources.pathify.com/space/RL/265617479/One+Step+Involve+Setup#Authentication). | `https://external-auth.presence.io/connect/token` | | Root URL | String | Your Involve instance’s [root URL](https://resources.pathify.com/space/RL/265617479/One+Step+Involve+Setup#Involve-Root-URL). | `https://external-api.presence.io` | | Pathify API Instance | Drop-down menu | The Campus Experience Hub API instance that this Recipe will use to manage Groups and Events. | `example_campus` | | Pathify Database Instance | Drop-down menu | The Pathify database instance, as created by Pathify’s internal database Connector, that this Recipe will use to retrieve requisite User information. | `example_v1_pathify_db` | | Notification Preference | Drop-down menu | How often this Recipe will send Notifications about the Groups and Events that it creates.
Options include:
- **Always** - **After Initial Sync** - **Never**
> ℹ️ Global- and User-level Notification settings still apply. | `Always` | --- ## Advanced Settings > ℹ️ This section treats this Recipe’s *Advanced Settings *parameters. **We firmly advise you against changing any of these parameters' default arguments unless you have been directed to do so by our customer success team.** > ℹ️ > ℹ️ If you fail to heed this warning, you take this Recipe’s efficacy into your own hands. > ℹ️ > ℹ️ Proceed at your own risk. ### Synchronization Queue Name
Ask yourself: "Have I been directed to change this parameter's default argument by Pathify's customer success team?" | **Parameter Name** | **Parameter Type** | **Description** | **Example** | | --- | --- | --- | --- | | Synchronization Queue Name | String | The name of the FLOW Queue that this Recipe will listen on. | `presence.io_organizations` |
--- ### Output Queue Name
Ask yourself: "Have I been directed to change this parameter's default argument by Pathify's customer success team?" | **Parameter Name** | **Parameter Type** | **Description** | **Example** | | --- | --- | --- | --- | | Output Queue Name | String | The name of the FLOW Queue that this Recipe will output to. | `presence_groups_queue` |
--- ### File Completion Alert Queue Name
Ask yourself: "Have I been directed to change this parameter's default argument by Pathify's customer success team?" | **Parameter Name** | **Parameter Type** | **Description** | **Example** | | --- | --- | --- | --- | | Alert Queue Name | String | The name of the FLOW Queue that this Recipe will publish file completion alerts to. | `file_completion_alerts@smtp` |
--- ### Group Type
Ask yourself: "Have I been directed to change this parameter's default argument by Pathify's customer success team?" | **Parameter Name** | **Parameter Type** | **Description** | **Example** | | --- | --- | --- | --- | | Group Type | String | The type that Groups created by this Recipe will be assigned. | `Organizations` |
--- ### Polling Interval
Ask yourself: "Have I been directed to change this parameter's default argument by Pathify's customer success team?" | **Parameter Name** | **Parameter Type** | **Description** | **Example** | | --- | --- | --- | --- | | Polling Interval | Integer | The interval, expressed in minutes, by which this Recipe will synchronize with Involve. | `1440` |
--- ### Attribute Mappings and Customizations
Ask yourself: "Have I been directed to change these parameters' default arguments by Pathify's customer success team?" | **Parameter Name** | **Parameter Type** | **Description** | **Example** | | --- | --- | --- | --- | | Attribute Mappings and Customizations | Array/object | Mappings between attributes found in Involve’s API responses (*inputKey*) and those expected by Pathify (*outputKey*).
Three attribute classifications exist:
- **Group** - **Event** - **User**
If needed, further massage mappings with their attendant JavaScript functions.
See below. | *inputKey*: `emailAddress`
*outputKey*: `email` | #### Attribute Mapping and Customization Example By default, there’s an object in this Recipe’s User attribute mappings that translates **emailAddress** (*inputKey*; what’s retrieved from Involve) to **email **(*outputKey*; what’s expected by Pathify). Additionally, this object has an attendant JavaScript function that further transforms the end results of its mappings, making sure that they’re lowercase. These behaviors are parameterized, so you can modify them if necessary.