> ## Documentation Index
> Fetch the complete documentation index at: https://ampersand-24eb5c1a-odoo-deep.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ConnectWise

## What's supported

### Supported actions

This connector supports:

* [Proxy Actions](/proxy-actions), using the base URL `https://{{.region}}.myconnectwise.net`.

### Example integration

To define an integration for ConnectWise, create a manifest file that looks like this:

```YAML theme={null}
# amp.yaml
specVersion: 1.0.0
integrations:
  - name: connectWise-integration
    displayName: My ConnectWise Integration
    provider: connectWise
    proxy:
      enabled: true
```

## Using the connector

This connector uses Basic Auth, which means that you do not need to set up a Provider App before getting started. (Provider apps are only required for providers that use OAuth2 Authorization Code grant type.)

To start integrating with ConnectWise:

* Create a manifest file like the example above.
* Deploy it using the [amp CLI](/cli/overview).
* Embed the [InstallIntegration](/embeddable-ui-components#install-integration) UI component. The UI component will prompt the customer for their username and password.
* Start making [Proxy Calls](/proxy-actions), and Ampersand will automatically attach the correct header required by Basic Auth. Please note that this connector's base URL is `https://{{.region}}.myconnectwise.net`.

## Credential format for ConnectWise

ConnectWise uses a non-standard format for Basic Auth. The username and password fields do not correspond to the actual username and password that a customer uses to log in. Instead:

* **Username**: The username will always begin with `CompanyId+` (the plus sign is literal) and then use either the `public key`, `integrator username`, or `MemberId` (e.g. `mycompany+8mr4fDio4MBPsER2`).
* **Password**: The password will be the `private key`, `integrator password`, or `member hash`.

[Click here](https://developer.connectwise.com/Products/Manage/REST/Authentication) for more information about the expected credential format for ConnectWise. The UI components will display this link, so that your users can successfully provide their credentials.