> ## 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 Intacct (OAuth)

## Overview

<CardGroup cols={3}>
  <Card title="Pre-built tooling" icon="screwdriver-wrench" href="#pre-built-tooling" />

  <Card title="Pre-built integrations" icon="square-check" href="#pre-built-integrations" />

  <Card title="Access requirements" icon="triangle-exclamation" href="#access-requirements" />

  <Card title="Setup guide" icon="rocket" href="#setup-guide" />

  <Card title="Useful links" icon="circle-info" href="#useful-links" />

  <Card title="API gotchas" icon="biohazard" href="#api-gotchas" />
</CardGroup>

## Pre-built tooling

<AccordionGroup>
  <Accordion title="✅ Authorization">
    | Tools                           | Status |
    | ------------------------------- | ------ |
    | Pre-built authorization (OAuth) | ✅      |
    | Credentials auto-refresh        | ✅      |
    | Auth parameters validation      | ✅      |
    | Pre-built authorization UI      | ✅      |
    | Custom authorization UI         | ✅      |
    | Expired credentials detection   | ✅      |
  </Accordion>

  <Accordion title="✅ Read & write data">
    | Tools                                     | Status                         |
    | ----------------------------------------- | ------------------------------ |
    | Pre-built integrations                    | ✅                              |
    | 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>

  <Accordion title="✅ 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>

  <Accordion title="✅ 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        | ✅                              |
  </Accordion>
</AccordionGroup>

### Accounts

| Function name | Description                                                    | Type                                           | Source code                                                                                                               |
| ------------- | -------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `accounts`    | Fetches a list of all accounts from your sage intacct account. | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/sage-intacct-oauth/syncs/accounts.ts) |

## Access requirements

| Pre-Requisites    | Status         | Comment                                                                                                     |
| ----------------- | -------------- | ----------------------------------------------------------------------------------------------------------- |
| Paid dev account  | ✅ Not required | Free, self-signup [here](https://developer.sage.com/intacct/).                                              |
| Paid test account | ✅ Not required | Create a 30 day free trial account [here](https://online.sageintacct.com/WebsiteAssets_request_trial.html). |
| Partnership       | ❓              |                                                                                                             |
| App review        | ❓              |                                                                                                             |
| Security audit    | ❓              |                                                                                                             |

## Setup guide

* You must have an active Sage Intacct Web Services developer license, which includes a Web Services sender ID and password or access to a free trial period account.
  <Tip>If you need a developer license, contact your account manager.</Tip>

<Steps>
  <Step title="Create a new developer workspace">
    Go to [developer console](https://developer.sage.com/intacct/) and login if you have an account or signup for a free developer's account.

    Click **View workspaces**, then enter your Sage account email address and password to log in.

    Click **Add workspace** to create a workspace for your company.

    Enter a name for your workspace and a contact email address, then click **Create**.
  </Step>

  <Step title="Add a client application">
    Click **Apps** in the left column navigation.

    Click **Add application**.

    Enter a name to identify the application in your workspace, a home page URL, and a contact email address for the application, then click **Create**.
  </Step>

  <Step title="Obtaining Client Credentials">
    From the list of applications in your workspace, click your new application to open it.

    Click **Create API keys**.

    From the **Sage Product API** drop-down list, select Sage Intacct.

    Enter a Redirect URI as a full URL. During the authorization process, users will be redirected to this URL after authorizing your application to access their data in Sage Intacct. You can configure the following Redirect URL: `https://api.nango.dev/oauth/callback`.

    If you have custom applications that send Sage Intacct API requests from your domains, enter those domains in **Allowed Origin Domains** as full https URLs.

    Enter your Sage Intacct Web Services sender ID and password.

    From the **Client Scope** drop-down list, select the type of company to associate with these API keys:

    * **Non-Production**: Choose this option if you're working with a sandbox implementation or other non-production company.

    * **Production**: Choose this option if you're working with a live production company. Production companies are limited to no more than five associated API keys.

    <Note>You cannot change the client scope after it has been set</Note>

    Click **Create**.

    When your registration is complete, the Application Details page will include an API Keys section. Click **Sage Intacct** in that list to view your application's **client ID** and **secret key**.
  </Step>

  <Step title="Next">
    Follow the [*Quickstart*](/getting-started/quickstart).
  </Step>
</Steps>

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

<Note>Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/sage-intacct-oauth.mdx)</Note>

## Useful links

| Topic     | Links                                                                                                                                |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| General   | [Website](https://www.sage.com/en-gb/sage-business-cloud/intacct/)                                                                   |
|           | [Create a test account](https://online.sageintacct.com/WebsiteAssets_request_trial.html)                                             |
| Developer | [API documentation](https://developer.sage.com/intacct/docs/)                                                                        |
|           | [Create or Login to a developer account](https://app-registry.sage.com/)                                                             |
|           | [Developer console](https://developer.sage.com/intacct/)                                                                             |
|           | [Authorization documentation](https://developer.sage.com/intacct/docs/developer-portal/guides/oauth2/#authorization-code-grant-type) |

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

## API gotchas

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