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

# Connect Nutshell

> Read contacts and activity — and write notes and tasks back.

Connecting Nutshell lets Rivvi read your contacts (People) and their activity, and write call notes and follow-up tasks back — keeping outreach in sync with your CRM. It uses your Nutshell email and API key; there's no marketplace app to install.

## What you'll need

* **Account email** — the email of your Nutshell user account (used as the API username)
* **API key** — a **standard** API key from Nutshell → Setup → API keys

<Warning>
  Create a **standard** key. A "web-only" key can't authenticate to the API.
</Warning>

<Card title="Nutshell: API authentication" icon="arrow-up-right-from-square" href="https://developers.nutshell.com/docs/api-authentication">
  Nutshell's authentication guide.
</Card>

## Connect it

<Steps>
  <Step title="Generate a standard API key">
    In Nutshell, go to **Setup → API keys** (`app.nutshell.com/setup/api-key`) and create a standard key.
  </Step>

  <Step title="Open Rivvi's connector settings">
    **Settings → Connectors**, select **Nutshell**, click **Connect**.
  </Step>

  <Step title="Paste your credentials">
    | Field             | What to paste                  |
    | ----------------- | ------------------------------ |
    | **Account email** | `you@yourcompany.com`          |
    | **API key**       | Your standard Nutshell API key |
  </Step>
</Steps>

## What Rivvi can do with Nutshell

**Read (allowed by default)**

* List the filterable fields on contacts, accounts, and leads, including custom ones.
* Search and page contacts (People); read by email.
* Read a contact and its details.
* List activities — calls, meetings, notes — optionally for one contact.

**Write (asks for approval by default)**

* Add a note to a contact's timeline.
* Create a follow-up task on a contact.
* Update fields on a contact.

## Try it

```text theme={null}
Find my Nutshell contacts we haven't touched in 60 days.
Log a note on this contact and create a follow-up task.
```

## Next

<Card title="Connectors overview" icon="plug" href="/connectors/overview">
  Back to all connectors.
</Card>