> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Sage People

## Overview

> [card] [Pre-built tooling](#pre-built-tooling)

> [card] [Pre-built integrations](#pre-built-integrations)

> [card] [Access requirements](#access-requirements)

> [card] [Setup guide](#setup-guide)

> [card] [Useful links](#useful-links)

> [card] [API gotchas](#api-gotchas)

## Pre-built tooling

> [accordion] ✅ Authorization
>
> | Tools | Status |
> | - | - |
> | Pre-built authorization (OAuth) | ✅ |
> | Credentials auto-refresh | ✅ |
> | Auth parameters validation | ✅ |
> | Pre-built authorization UI | ✅ |
> | Custom authorization UI | ✅ |
> | End-user authorization guide | ✅ |
> | Expired credentials detection | ✅ |

> [accordion] ✅ Read & write data
>
> | Tools | Status |
> | - | - |
> | Pre-built integrations | 🚫 (time to contribute: \<48h) |
> | API unification | ✅ |
> | 2-way sync | ✅ |
> | Webhooks from Nango on data modifications | ✅ |
> | Real-time webhooks from 3rd-party API | 🚫 (time to contribute: \<48h) |
> | Proxy requests | ✅ |

> [accordion] ✅ Observability & data quality
>
> | Tools | Status |
> | - | - |
> | HTTP request logging | ✅ |
> | End-to-end type safety | ✅ |
> | Data runtime validation | ✅ |
> | OpenTelemetry export | ✅ |
> | Slack alerts on errors | ✅ |
> | Integration status API | ✅ |

> [accordion] ✅ Customization
>
> | Tools | Status |
> | - | - |
> | Create or customize use-cases | ✅ |
> | Pre-configured pagination | 🚫 (time to contribute: \<48h) |
> | Pre-configured rate-limit handling | 🚫 (time to contribute: \<48h) |
> | Per-customer configurations | ✅ |

*No pre-built syncs or tools available yet.*

> [!TIP]
>
> Not seeing the integration you need? [Build your own](https://nango.dev/docs/guides/functions/functions-guide.md) independently.

## Access requirements

| Pre-Requisites | Status | Comment |
| - | - | - |
| Paid dev account | ✅ Not required | Free, self-signup for a [Salesforce Developer Edition](https://developer.salesforce.com/signup). |
| Paid test account | ✅ Not required | Developer Edition can be used for testing. |
| Partnership | ✅ Not required | |
| App review | ✅ Not required | Only required for apps published on AppExchange. |
| Security audit | ✅ Not required | |

## Prerequisites

Before setting up Sage People integration, you need to configure Salesforce OAuth which is managed via a Connected app as Sage People uses Salesforce credentials for authentication.

## Salesforce Developer Account Setup

### New Salesforce Users

If you don't have a Salesforce account yet, follow these steps:

**1. Sign up for Salesforce Developer Edition**

1. Go to [Salesforce Developer Edition signup](https://developer.salesforce.com/signup)
2. Fill in your details and create a free Developer Edition account
3. Verify your email address
4. Complete the account setup process

**2. Enable Connected Apps**

1. Log in to your Salesforce Developer Edition account
2. Navigate to **Setup** > **Apps** > **External Client App Manager** > **Settings**
3. Toggle the button for **Allow creation of connected apps**
4. Click **Enable**
   \[!NOTE] Connected Apps are disabled by default in new Salesforce organizations

## Creating a Connected App

**1. Configure Connected App settings**

1. Click **New Connected App**.
2. Fill in the required basic information:
   * **Connected App Name**: Your app's name
   * **API Name**: Will auto-populate
   * **Contact Email**: Your email address
3. Check the **Enable OAuth Settings** checkbox.
4. For **Callback URL**, enter: `https://api.nango.dev/oauth/callback`.
5. Under **Selected OAuth Scopes**, add the permissions your app needs. At minimum, add:
   * "Access and manage your data (api)"
   * "Perform requests on your behalf at any time (refresh\_token, offline\_access)"
6. Leave the rest of the default settings unchanged.
7. Click **Save**, then **Continue**.
   \[!NOTE] Changes can take up to 10 minutes to take effect

**2. Obtain API credentials**

1. After saving, you'll be redirected to the Connected App detail page.
2. You may need to wait a few minutes for the app to be fully created.
3. Click **Manage Consumer Details** to view your credentials. You may be required to verify your identity.
4. Copy the **Consumer Key** (this is your Client ID) and **Consumer Secret** (this is your Client Secret).
5. You will need these credentials when configuring your integration in Nango.

**3. Configure token settings (recommended)**

1. Under the **Connected Apps** dropdown, click **Manage Connected Apps**, then click the **Edit** button next to your application.
2. Under **OAuth Policies**, set **Refresh Token Policy** to "Refresh token is valid until revoked" for long-lived access.
3. Click **Save**.

**4. Next**

Follow the [*Quickstart*](https://nango.dev/docs/getting-started/quickstart.md).

> [!TIP]
>
> Need help getting started? Get help in the [community](https://nango.dev/slack).

## Useful links

| Topic | Links |
| - | - |
| General | [Sage People Website](https://www.sage.com/en-us/sage-business-cloud/people/) |
| | [Salesforce Website](https://www.salesforce.com/) |
| | [Get a free Salesforce Developer Edition](https://developer.salesforce.com/signup) |
| | [Sage People help center home](https://help-people.sage.com/Content/Home/_Home.htm?tocpath=_____1) |
| Developer | [Sage People API documentation](https://developer.sage.com/people/) |
| | [Sage People API Getting Started Guide](https://developer.sage.com/people/get-started/) |
| | [Create a Sage People API User](https://developer.sage.com/people/get-started/#create-a-sage-people-api-user) |
| | [Obtain an Access Token](https://developer.sage.com/people/get-started/#obtain-an-access-token) |
| | [Sage People API Reference](https://developer.sage.com/people/reference/) |
| | [Salesforce Authentication Documentation](https://help.salesforce.com/articleView?id=remoteaccess_authenticate.htm) |

> [!NOTE]
>
> Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/sage-people.mdx)

## API gotchas

* **Salesforce Authentication**: Sage People uses Salesforce authentication, so you must set up a Salesforce OAuth app first.
* **Sage People API User**: After setting up the Salesforce Connected App, you need to [create a new API user](https://nango.dev/docs/integrations/all/sage-people/connect#step-1-create-a-sage-people-api-user) within Sage People with the necessary permission sets where we have the **Sage People API** package installed. This user will be used to authenticate with the Connected App you created above.

> [!NOTE]
>
> Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/sage-people.mdx)

## Going further

> [card] [Connect to Sage People](https://nango.dev/docs/integrations/all/sage-people/connect)
>
> Guide to connect to Sage People using Connect UI


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.