> 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

{% 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="/files/hDhsUkoliKpsmAPa20O4" 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="/files/HXkBCG9cPvf9WJbdBq8C" alt="" width="210"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="/files/aq5B594qhfA9oInO4ssy" 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.phocassoftware.com/administration/connectors.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.