Source: https://docs.pageloop.ai/guides/document360-integration

# Document360 integration

# Document360 integration

Connect Document360 so Pageloop can read your published help-center articles and prepare updates for review. You choose one project version to sync and decide when to publish changes back to Document360.

For an overview of help-center connections and integration roles, see [Connect your knowledge base](/guides/connect-knowledge-base).

## Before you begin

- Sign in to Pageloop as an **Admin**.
- Have your **Help Center URL**, the public address of your Document360 site containing `<your subdomain>`.
- Have a Document360 **API Token** (`<your API key>`) allowed to read project versions. The connection dialog's **Find your API Token** link opens Document360's API token guide.
- Know which project version contains the articles you want to sync. API documentation versions are not offered.

## Connect and configure Document360

1. Open **Integrations**, search for **Document360**, and select **Connect**.

![Document360 integration card with the Connect button](/images/uploads/uploaded-image-0-11c237dd.png)

2. In **Connect Document360**, enter **Help Center URL** and **API Token**, then select **Connect**. The **Integration Connected** toast with **Successfully connected to Document360** confirms the connection.

![Connect Document360 dialog with sample values, a masked key, and Connect outlined](/images/uploads/uploaded-image-1-0c2cdf6b.png)

> [!WARNING]
>
> The card reads **Connected** before you choose a project version. Nothing syncs until you save a version, so complete the configuration right away.

3. Select the gear (**Configure**) on the Document360 card. In **Configure Document360**, under **Select a project version to sync**, choose one version. The main version is marked **Main**. Select **Save Configuration** and check for **Configuration saved**. You can reopen Configure to change the version at any time.

![Configure Document360 dialog with a project version and Save Configuration outlined](/images/uploads/uploaded-image-1-63ed6055.png)

4. Confirm that the card reads **Connected** and has a gear button. Check the **Knowledge base** role under **Integration roles** before relying on the connection to sync articles.

![Connected Document360 card with its gear button and Document360 assigned to the Knowledge base role](/images/uploads/uploaded-image-3-6d955b00.png)

### Assign the Knowledge base role

Document360 can hold the **Knowledge base** role only. The role identifies where Pageloop reads your articles and publishes updates.

Connecting Document360 assigns it to **Knowledge base** only when no service holds that role. If another service, such as **Pageloop Docs**, already holds the role, Document360 connects but is not synced until you change the assignment:

1. Scroll to **Integration roles** at the bottom of **Integrations**.
2. Select **Change** on **Knowledge base**.
3. In **Change Knowledge Base**, which says **Pick a connected service to read from and write to.**, select **Document360**.
4. Select **Save** and confirm that **Knowledge base** names **Document360**.

## What Pageloop reads and writes

### Read articles from Document360

With a saved project version and the **Knowledge base** role assigned to Document360, Pageloop syncs published articles, categories, and sections from that version every hour. Pageloop does not offer API documentation versions for sync.

### Publish reviewed changes to Document360

Pageloop's proposals arrive in the **Inbox**. Nothing reaches Document360 until a person publishes an article.

When you publish an article, choose where it goes, select a category, and choose an author. The author defaults to you. Select **Publish** to publish the article, or **Save as draft in Document360** to create a draft in Document360 rather than publish it.

See [Review an Inbox item](/guides/review-inbox-item) and [Finish an Inbox item](/guides/finish-an-inbox-item) for the review and publishing workflow.

## Disconnect Document360

1. On the Document360 card, point at **Connected**. The button changes to **Disconnect**.
2. Select **Disconnect** to open **Disconnect Document360?**. The dialog explains: **Pageloop stops reading from and writing to it.** If Document360 holds the Knowledge base role, the dialog also says: **Document360 is your knowledge base integration. That role is left unassigned until you pick another.**
3. Select **Disconnect** to confirm, or **Keep connected** to cancel. The **Document360 disconnected** toast confirms disconnection.

![Disconnect Document360? dialog with Disconnect outlined](/images/uploads/uploaded-image-4-595b0108.png)

Disconnecting leaves the API token valid in Document360. Delete the token in Document360 if you no longer want Pageloop to have access. The saved project version choice is lost; choose a version again after reconnecting.

### Restore a connection that needs reconnecting

If Pageloop loses access, for example because the key was deleted or syncing failed several times in a row, the card shows **Needs reconnecting**. The page says: **Document360 needs to be reconnected. Pageloop lost access, so it is paused until you reconnect it.**

Open the **...** menu on the card and select **Disconnect**. Then select **Connect** and repeat the connection and configuration steps, including saving a project version and checking the Knowledge base role.

## Troubleshooting

| Message or symptom                                                                                                                                                                   | What to do                                                                                                 |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
| **Connection Failed** with **Invalid Document360 API token or insufficient permissions**                                                                                             | Check the API token and confirm that it is allowed to read project versions, then try connecting again.    |
| The Knowledge base page keeps showing **Reading your Document360 help center** with no articles.                                                                                     | No project version is saved. Open the card's gear, choose a version, and select **Save Configuration**.    |
| **Error loading project versions**                                                                                                                                                   | The version list did not load. Try again, or disconnect and connect again.                                 |
| **Please select a project version**                                                                                                                                                  | Choose a version before saving.                                                                            |
| Document360 is **Connected**, but articles are not syncing after you saved a version.                                                                                                | Check **Integration roles**. If another service holds **Knowledge base**, change the role to Document360.  |
| **Needs reconnecting**                                                                                                                                                               | Open the card's **...** menu, select **Disconnect**, then connect and configure Document360 again.         |
| **Pageloop can’t sign in to your Document360 help center, so it isn’t syncing.**                                                                                                     | Disconnect, then connect and configure Document360 again.                                                  |
| **Pageloop stopped syncing your Document360 help center after it failed several times in a row.**                                                                                    | Disconnect, then connect and configure Document360 again.                                                  |
| **The last sync of your Document360 help center didn’t finish. Pageloop keeps trying on its own.**                                                                                   | Pageloop retries automatically.                                                                            |
| **Pageloop paused syncing: most of your Document360 articles were missing from the last read, so it kept them rather than delete them. If you didn’t remove them, contact support.** | If you did not remove the articles, contact support. Pageloop kept the articles rather than deleting them. |

## Related guides

- [Connect your knowledge base](/guides/connect-knowledge-base)
- [Review an Inbox item](/guides/review-inbox-item)
- [Finish an Inbox item](/guides/finish-an-inbox-item)
- [Troubleshooting](/guides/troubleshooting)
