# The anatomy of a service connector

## Introduction

When you [add](https://doc.wearepatchworks.com/product-documentation/patchworks-services/service-connectors/adding-a-service-connector) or [update](https://doc.wearepatchworks.com/product-documentation/patchworks-services/service-connectors/updating-a-service-connector) a connector, information and options are shown within two tabs:

* [Connector summary](#connector-summary)
* [Connector settings](#connector-settings)

## Connector summary

The connector **summary** tab shows the current [status of the connector](#connector-status), together with snapshot sync/transaction totals and a list of [failed syncs](https://doc.wearepatchworks.com/product-documentation/patchworks-services/troubleshooting/how-to-manage-failed-service-syncs):

<figure><img src="https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/sNz3A7I9EbQn4P20xAqg/connector%20page%20-%20not%20annotated%20.png" alt=""><figcaption></figcaption></figure>

### Connector status

The current status of a connector is displayed at the top of the **summary** tab:&#x20;

<figure><img src="https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/cQvR1PwRRoTJQK4mZa73/connector%20health%20check%20example%20-%20full.png" alt=""><figcaption></figcaption></figure>

Behind the scenes, Patchworks is checking if connectors are operational - i.e. that the associated system can be reached and authenticated using the details provided. Possible statuses are:

<table><thead><tr><th width="323">Status</th><th></th></tr></thead><tbody><tr><td>Connector Operational</td><td>The system can be reached and authenticated with the details provided.</td></tr><tr><td>System Unreachable</td><td>The URL provided for this connector cannot be reached.</td></tr><tr><td>Failed Authentication</td><td>Authentication cannot be completed using the details provided. </td></tr></tbody></table>

## Connector settings

The connector **settings** tab is used to view/update general settings for the connector (name, time zone and date format). It also includes a **credentials** panel - these details will vary, depending on the associated system:

<figure><img src="https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/skcp4a9Ztn3KJY1wUO3S/connector%20settings.png" alt=""><figcaption></figcaption></figure>

### Updating connector credentials

If your authentication credentials ever change for a system, you can update them here.&#x20;

You only need to update your single connector - any change will be picked up by all services that are configured to use this connector as a source or destination.


---

# Agent Instructions: 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:

```
GET https://doc.wearepatchworks.com/product-documentation/patchworks-services/service-connectors/the-anatomy-of-a-service-connector.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.