# Rippling SSO App

1. Add a Custom App in Rippling. 
2. Go to **IT Management** > **Custom App** from the left navigation menu. 
3. Click **Create New App** button to create a new application.

   From the next screen, fill in the following fields:

   * **App Name -** TrustSwiftly
   * **Select Categories** 
   * **Upload Logo -** You can download <https://app.trustswiftly.com/assets/images/icon.png> and use as an icon or download the below.

   <figure><img src="/files/iI1NeGYiGgqt9Sjmc417" alt="" width="188"><figcaption></figcaption></figure>

   * **What type of app would you like to create?** - Make sure you select **Single Sign-On (SAML)** from the list.

   <br>
4. Copy the IdP Metadata URL from Rippling. i.e. similar too

<pre class="language-html"><code class="lang-html"><strong>https://app.rippling.com/api/platform/sso/idp-metadata/XXXXXXXXXXXXXX
</strong></code></pre>

5. Paste it in your Trust Swiftly Auth settings /settings/auth and save it.
6. In Rippling for the paste the Trust Swiftly metadata URL&#x20;

```
https://[COMPANY].trustswiftly.com/auth/saml2/metadata
```

7. Edit the app for advanced SSO configuration to match the below settings. Make sure SP initiated login is checked.&#x20;

<figure><img src="/files/FeR0N8EgHtIRSFwKA6bS" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/43Xjbvcy9kgXgv3atqRT" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/1ktty3kdx5qz2JjpxUxV" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.trustswiftly.com/single-sign-on/rippling-sso-app.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.