> ## 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.

# Outreach

## 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                    | 🚫 (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>

  <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>

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

<Tip>Not seeing the integration you need? [Build your own](/guides/functions/functions-guide) independently.</Tip>

## Access requirements

| Pre-Requisites    | Status         | Comment                                              |
| ----------------- | -------------- | ---------------------------------------------------- |
| Paid dev account  | ✅ Not required | Free Outreach account is sufficient for development. |
| Paid test account | ✅ Not required | Free Outreach account is sufficient for testing.     |
| Partnership       | ✅ Not required |                                                      |
| App review        | ✅ Not required | No review process for OAuth apps.                    |
| Security audit    | ✅ Not required |                                                      |

## Setup guide

<Steps>
  <Step title="Create an Outreach account">
    1. If you don't already have an Outreach account, go to [Outreach's signup page](https://www.outreach.io/free-trial) and create one.
    2. Sign in to your Outreach account.
  </Step>

  <Step title="Access the developer portal">
    1. Go to the [Outreach Developer Portal](https://developers.outreach.io/).
    2. Sign in with your Outreach credentials.
    3. Navigate to "My apps" in the top navigation bar.
  </Step>

  <Step title="Create a new Outreach app">
    1. In the developer portal, click on **Create App**.
    2. Fill in the required information for your application:
       * **App Name**: Enter a name for your application.
       * **App Description**: Provide a brief description of what your application does.
       * **Company Name**: Enter your company name.
       * **App Website**: Enter the URL of your application's website.
       * **Support Email**: Enter an email address for support inquiries.
  </Step>

  <Step title="Configure API access">
    1. After creating your app, navigate to the **API access** tab.

    2. Enable the Outreach API access by toggling the switch.

    3. Add the following redirect URI:
       * `https://api.nango.dev/oauth/callback`

    4. Select the appropriate scopes for your application based on your needs. Common scopes include:
       * `accounts.all` - Access to account information
       * `prospects.all` - Access to prospect information
       * `sequences.all` - Access to sequence information
       * `users.all` - Access to user information

    5. Save your application settings.
  </Step>

  <Step title="Obtain your OAuth credentials">
    After configuring API access, you'll receive:

    * **Client ID**: A unique identifier for your application
    * **Client Secret**: A secret key for your application

    Make sure to store these securely, especially the Client Secret, as you'll need them when configuring your integration in Nango. Note that the Client Secret will only be displayed once, so make sure to copy it immediately.
  </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/outreach.mdx)</Note>

## Useful links

* [Outreach Developer Portal](https://developers.outreach.io/)
* [API Overview](https://developers.outreach.io/api/)
* [Authentication Documentation](https://developers.outreach.io/api/oauth/)
* [OAuth in a Nutshell](https://developers.outreach.io/api/oauth/#oauth-in-a-nutshell)
* [Setting up OAuth](https://developers.outreach.io/api/oauth/#setting-up-oauth)
* [API Reference](https://developers.outreach.io/api/reference/overview/)
* [Getting Started](https://developers.outreach.io/api/getting-started/)
* [Making Requests](https://developers.outreach.io/api/making-requests/)

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

## Common Scopes

| Scope            | Description                                   |
| ---------------- | --------------------------------------------- |
| `accounts.all`   | Read and write access to account information  |
| `accounts.read`  | Read-only access to account information       |
| `prospects.all`  | Read and write access to prospect information |
| `prospects.read` | Read-only access to prospect information      |
| `sequences.all`  | Read and write access to sequence information |
| `sequences.read` | Read-only access to sequence information      |
| `users.all`      | Read and write access to user information     |
| `users.read`     | Read-only access to user information          |
| `mailboxes.all`  | Read and write access to mailbox information  |
| `mailboxes.read` | Read-only access to mailbox information       |
| `calls.all`      | Read and write access to call information     |
| `calls.read`     | Read-only access to call information          |
| `emails.all`     | Read and write access to email information    |
| `emails.read`    | Read-only access to email information         |

## API gotchas

* Rate limits apply to the Outreach API. If you exceed the rate limit, you'll receive a 429 Too Many Requests response.

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