> For the complete documentation index, see [llms.txt](https://docs.phocassoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.phocassoftware.com/administration/connectors.md).

# Connectors

View and run the data connectors that are set up for your Phocas site.

{% hint style="info" %}
Connectors are set up for your site by our Implementation team, as it is an advanced technical process. [Contact our Support team](https://portal.usepylon.com/phocas/login) if you need to set up a new connector, modify an existing connector, or enable other users to run a connector.
{% endhint %}

Connectors are a way to get your data into Phocas. They are data synchronization tools that connect to third-party systems to read data. A typical connector might request data from a third-party API, such as Paylocitiy, Sage, Formstack, and IPS, and bring it into Phocas.

Administrators can run a connector from within the **Connectors** page. Non-administrators can run a connector from the **Toolbox**. The toolbox method is available on request and a Phocas consultant must give the nominated users permission to run the connectors.

## Run a connector: Administrator

{% hint style="info" %}
User permission: Administration > Connector
{% endhint %}

Click **Administration** > **Connectors**, select the connector row, and click **Run**.

<div align="left"><figure><img src="https://content.gitbook.com/content/vQCmtGTR7MsjcI62Vdki/blobs/xTJkiTwvKShrRDKWVa2v/3411510055.png" alt="image-20240320-195057.png" width="110"><figcaption></figcaption></figure></div>

## Run a connector: Non-administrator

If you have permission, the **Connectors** option will display in your **Toolbox** menu, allowing you to run connector(s).

In the Phocas menu, click **Toolbox** > **Connectors**.

<div align="left"><figure><img src="https://content.gitbook.com/content/vQCmtGTR7MsjcI62Vdki/blobs/xZzTAeqzqjIGsJQUHiSS/3213394038" alt="" width="210"><figcaption></figcaption></figure></div>

On the **Connectors** page, select the connector row and click **Run**.

<div align="left"><figure><img src="https://content.gitbook.com/content/vQCmtGTR7MsjcI62Vdki/blobs/s2lNcwuqsOhw7sHn7QEh/3213394023.png" alt="" width="272"><figcaption></figcaption></figure></div>


---

# 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.phocassoftware.com/administration/connectors.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.