> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/knowledge-base/workvivo.md).

# Workvivo

The Workvivo integration lets you connect your Workvivo employee-experience platform as a Knowledge Base source in Harmony. Once connected, your Workvivo content becomes available to support workflows, so agents and automated processes can draw on the same articles and pages your employees rely on every day.

### What gets imported

When you set up the Workvivo integration, you choose exactly which content to bring in using the space picker. The following options are available:

* **Company-wide articles** - Select the **\[Global]** option to include org-wide articles that live outside any specific space. These are the articles published to your entire organization.
* **Public space content** - Select one or more individual public spaces to import their pages, articles, and documents, including file attachments and external links.

#### Content safety

By default, only org-visible content is imported. Private team-only content is excluded by default, so you never have to worry about surfacing restricted material to unintended audiences.

### Prerequisites

Before you begin, make sure you have:

* A Workvivo account with administrator access
* A Workvivo API token, your organization's Workvivo ID and, if your organization is not hosted in the US, its API URL. In Workvivo, open **Administration** > **API Keys and JWT Settings**, click **Add New App**, choose **API Key** as its authentication method and give it read permissions for articles, documents, pages, spaces and users. Then click **Manage Keys** > **Add New Key** and copy the token before you close the window: Workvivo does not show it again. The same page shows your Workvivo ID and your organization's base API URL. It requires the Developer role, and Workvivo Support must first enable API access for your organization
* Permission to manage integrations in your Harmony workspace

### Connect Workvivo as a Knowledge Base source

1. In Harmony, go to **Settings** > **Integrations** and click the **Workvivo** card under **Knowledge Base**.
2. Enter:
   * **API key**: your Workvivo API token
   * **Workvivo ID**: your organization's numeric Workvivo ID
   * **API URL**: the base API URL for your Workvivo region, for example `https://api.workvivo.us/v1`. Leave it empty only if your organization is hosted in the US (`api.workvivo.us`); other regions must enter theirs
3. Click **Connect**.
4. The window stays open and the space picker loads. Use it to select the content you want to import:
   * Select **\[Global]** to include company-wide articles.
   * Select any individual public spaces whose content you want to bring in.
5. Click **Save Changes**. Harmony will begin importing the selected content. Nothing is imported until you select **\[Global]** or at least one space.

### Managing your Workvivo source

After the initial setup you can return to **Settings** > **Integrations** > **Workvivo** at any time to:

* Add or remove spaces from your selection, then click **Save Changes**
* Refresh the list of available spaces
* Replace the API key: click **Replace** next to **API key**, paste the new token and click **Save Changes**
* Disconnect the integration entirely

### Content scope reference

| Content type                      | How to include it                               |
| --------------------------------- | ----------------------------------------------- |
| Org-wide articles                 | Select **\[Global]** in the space picker        |
| Public space pages                | Select the relevant space in the space picker   |
| File attachments in public spaces | Included automatically when a space is selected |
| External links in public spaces   | Included automatically when a space is selected |
| Private or team-only content      | Not imported - excluded by default              |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.harmony.io/integrations/knowledge-base/workvivo.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
