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

# OpenAI

> Connect OpenAI to Vivacity - gpt models for drafting.

<Info>
  **Category:** AI · **Access:** read-only at setup · **Actions:** drafted for your approval
</Info>

Connect **OpenAI** so Vivacity can see an AI model provider and help you act on it. Your data stays **read-only** while Vivacity learns. Anything it suggests is **drafted for you to approve** - it never sends or changes anything in OpenAI without your sign-off.

<Note>OpenAI is an AI model provider, not a data source. Vivacity uses it only to draft and reason over the data **you** connect.</Note>

## What Vivacity does with OpenAI

* Power drafting and reasoning for your workflows.
* Run inside Vivacity's approval-gated runtime.
* Used only on the data you connect.

## What syncs

Vivacity reads the following from OpenAI (read-only):

* Model access used to draft and reason
* Not a data source - Vivacity only uses the data you connect

<Note>Vivacity only ever **reads** the data you connect. It does not write back to OpenAI unless you explicitly approve an action.</Note>

## Connect OpenAI

<Steps>
  <Step title="Open Connectors">
    In Vivacity, go to **Settings → Connectors**.
  </Step>

  <Step title="Choose OpenAI">
    Find **OpenAI** under **AI** and select **Connect**.
  </Step>

  <Step title="Add your OpenAI API key">
    Paste your OpenAI API key when prompted. Vivacity stores it **encrypted** and uses it only to read the data you approve. (Find the key in your OpenAI account settings.)
  </Step>

  <Step title="Choose what to share">
    Pick the account, store or property to sync, then confirm.
  </Step>

  <Step title="Confirm the connection">
    Vivacity runs a first sync. You'll see a **Connected** badge when it's ready (usually a few minutes).
  </Step>
</Steps>

## Permissions & security

* **Read-only by default.** Setup grants read access only.
* **You stay in control.** Every suggested action is drafted for your approval before anything happens.
* **Encrypted & revocable.** Credentials are stored encrypted; disconnect any time in **Settings → Connectors**.

See [Data & permissions](/connectors/data-and-permissions) for the full picture.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The connection failed or won't authorise">
    Make sure you're signed in to the correct OpenAI account with admin access, then retry. If a pop-up was blocked, allow pop-ups for Vivacity and try again. Still stuck? See [Connection issues](/troubleshooting/connection-issues).
  </Accordion>

  <Accordion title="My OpenAI data looks out of date">
    Vivacity syncs on a schedule. Trigger a manual sync from **Settings → Connectors → OpenAI → Sync now**, or see [Data & sync](/troubleshooting/data-and-sync).
  </Accordion>

  <Accordion title="I see “Reconnect required”">
    OpenAI access can expire or be revoked. Open the connector and select **Reconnect** to restore it - your history is kept.
  </Accordion>
</AccordionGroup>

## Watch: connecting OpenAI

<Frame>
  <iframe width="100%" height="400" src="about:blank" title="Connecting OpenAI to Vivacity" frameborder="0" allowfullscreen />
</Frame>

<Card title="Browse all connectors" icon="grid-2" href="/connectors/introduction">
  See every tool you can connect to Vivacity.
</Card>