> This page is for API Reference & Tools.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.moveworks.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.moveworks.com/_mcp/server.

# Connector Systems D–M

> Fields and example bodies for each external system a Configuration API connector supports (D–M).

Per-system connector reference (DROPBOX → MANAGE_ENGINE). Every connector is created with `POST /platform/connectors` and the body `{"name": ..., "system": ..., "<system>_config": {...}, "version": {"change_description": ...}}`. Send the config block that matches `system`, and no other.

## EXTERNAL_SYSTEM_DROPBOX

Config block: `dropbox_config`

Dropbox connection settings, used when system is EXTERNAL_SYSTEM_DROPBOX. Set exactly one system-specific config.

| Field            | Type               | Required | Notes                                                                                                                                 |
| ---------------- | ------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `select_user_id` | string             |          | Team member ID of the service account. Dropbox requires it to identify the user accessing content.                                    |
| `path_root_id`   | string             |          | ID of the root folder where content ingestion starts.                                                                                 |
| `oauth2_refresh` | OAuth2RefreshToken |          | OAuth 2.0 refresh token grant using the client ID, client secret, and refresh token of your Dropbox app. Set exactly one auth method. |
| `on_prem_auth`   | OnPremiseAuth      |          | On-premise authentication through a Moveworks Agent running in your network. Set exactly one auth method.                             |

Set at most one of `oauth2_refresh`, `on_prem_auth`.

Example create body:

```json
{
  "name": "dropbox_connector",
  "system": "EXTERNAL_SYSTEM_DROPBOX",
  "dropbox_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_DUO

Config block: `duo_config`

Duo connection settings, used when system is EXTERNAL_SYSTEM_DUO. Set exactly one system-specific config.

| Field             | Type           | Required | Notes                                                                                            |
| ----------------- | -------------- | -------- | ------------------------------------------------------------------------------------------------ |
| `base_url`        | DuoStandardUrl |          | Duo Admin API hostname, built from scheme, subdomain, and domain.                                |
| `integration_key` | string         |          | Integration key of your Duo Admin API application. Secret: always returned masked as \*\*\*\*\*. |
| `secret_key`      | string         |          | Secret key of your Duo Admin API application. Secret: always returned masked as \*\*\*\*\*.      |

Example create body:

```json
{
  "name": "duo_connector",
  "system": "EXTERNAL_SYSTEM_DUO",
  "duo_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_EIGHT_X_EIGHT

Config block: `eight_x_eight_config`

8x8 connection settings, used when system is EXTERNAL_SYSTEM_EIGHT_X_EIGHT. Set exactly one system-specific config.

| Field          | Type                   | Required | Notes                                                                                                     |
| -------------- | ---------------------- | -------- | --------------------------------------------------------------------------------------------------------- |
| `standard_url` | StandardEightXEightUrl |          | Base URL of the 8x8 API, built from scheme, subdomain, and domain.                                        |
| `api_key_auth` | ApiKeyAuth             |          | API key authentication for 8x8. Set exactly one auth method.                                              |
| `on_prem_auth` | OnPremiseAuth          |          | On-premise authentication through a Moveworks Agent running in your network. Set exactly one auth method. |

Set at most one of `api_key_auth`, `on_prem_auth`.

Example create body:

```json
{
  "name": "eight_x_eight_connector",
  "system": "EXTERNAL_SYSTEM_EIGHT_X_EIGHT",
  "eight_x_eight_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_EXCHANGE

Config block: `exchange_config`

Microsoft Exchange Online connection settings, used when system is EXTERNAL_SYSTEM_EXCHANGE. Set exactly one system-specific config.

| Field             | Type                  | Required | Notes                                                                                                                                                         |
| ----------------- | --------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `app_id`          | string                |          | Application (client) ID of the Microsoft Entra app registration used to connect to Exchange Online.                                                           |
| `tenant_domain`   | ExchangeTenantDomain  |          | Your Microsoft 365 tenant domain, built from scheme, subdomain, and domain (for example, [https://company.onmicrosoft.com](https://company.onmicrosoft.com)). |
| `modern_pki_auth` | ExchangeModernPKIAuth |          | Certificate-based authentication using the certificate registered on your Microsoft Entra app.                                                                |

Set at most one of `modern_pki_auth`.

Example create body:

```json
{
  "name": "exchange_connector",
  "system": "EXTERNAL_SYSTEM_EXCHANGE",
  "exchange_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_FIELDGLASS

Config block: `fieldglass_config`

SAP Fieldglass connection settings, used when system is EXTERNAL_SYSTEM_FIELDGLASS. Set exactly one system-specific config.

| Field                       | Type                              | Required | Notes                                                                                                                                           |
| --------------------------- | --------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `custom_base_url`           | CustomBaseUrl                     |          | Base URL of your SAP Fieldglass instance.                                                                                                       |
| `system_timezone`           | string                            |          | Time zone of your Fieldglass system as a time zone name (for example, America/Los_Angeles). Only letters, underscores, and slashes are allowed. |
| `oauth2_client_credentials` | FieldglassOAuth2ClientCredentials |          | Authentication with a Fieldglass username, password, and client-specific application key. Set exactly one auth method.                          |
| `on_prem_auth`              | OnPremiseAuth                     |          | On-premise authentication through a Moveworks Agent running in your network. Set exactly one auth method.                                       |

Set at most one of `oauth2_client_credentials`, `on_prem_auth`.

Example create body:

```json
{
  "name": "fieldglass_connector",
  "system": "EXTERNAL_SYSTEM_FIELDGLASS",
  "fieldglass_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_FIVE_NINE

Config block: `five_nine_config`

Five9 connection settings, used when system is EXTERNAL_SYSTEM_FIVE_NINE. Set exactly one system-specific config.

| Field                                             | Type                | Required | Notes                                                                                                               |
| ------------------------------------------------- | ------------------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
| `service_now_url`                                 | StandardSnowUrl     |          | Base URL of the ServiceNow instance where live agent conversation tickets are created.                              |
| `service_now_agent_id_url`                        | string              |          | ServiceNow endpoint used to look up the agent ID on the instance where live agent conversation tickets are created. |
| `service_now_work_note_transcript_attachment_url` | string              |          | ServiceNow endpoint used to attach the live agent conversation transcript to the ticket as a work note.             |
| `basic_auth`                                      | BasicAuthentication |          | Username and password of the ServiceNow account used to attach transcripts. Required. Checked when saved.           |

Example create body:

```json
{
  "name": "five_nine_connector",
  "system": "EXTERNAL_SYSTEM_FIVE_NINE",
  "five_nine_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_FRESH_CHAT

Config block: `fresh_chat_config`

Freshchat connection settings, used when system is EXTERNAL_SYSTEM_FRESH_CHAT. Set exactly one system-specific config.

| Field                     | Type                 | Required | Notes                                                                                                                                                   |
| ------------------------- | -------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `standard_url`            | StandardFreshChatUrl |          | Standard Freshchat base URL, built from scheme, subdomain, and domain. Set either this or custom_url.                                                   |
| `custom_url`              | CustomBaseUrl        |          | Custom base URL of your Freshchat instance. Use when your instance is not on the standard domain. Set either this or standard_url.                      |
| `api_key_auth`            | ApiKeyAuth           |          | API key authentication for Freshchat. Set exactly one auth method.                                                                                      |
| `on_prem_auth`            | OnPremiseAuth        |          | On-premise authentication through a Moveworks Agent running in your network. Set exactly one auth method.                                               |
| `user_polling_start_date` | string               |          | Date from which user ingestion starts, in ISO 8601 format (for example, 2023-10-01T00:00:00Z). If not set, defaults to 30 days before the current date. |

Example create body:

```json
{
  "name": "fresh_chat_connector",
  "system": "EXTERNAL_SYSTEM_FRESH_CHAT",
  "fresh_chat_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_FRESH_DESK

Config block: `fresh_desk_config`

Freshdesk connection settings, used when system is EXTERNAL_SYSTEM_FRESH_DESK. Set exactly one system-specific config.

| Field          | Type                 | Required | Notes                                                                                                     |
| -------------- | -------------------- | -------- | --------------------------------------------------------------------------------------------------------- |
| `standard_url` | StandardFreshDeskUrl |          | Base URL of your Freshdesk instance, built from scheme, subdomain, and domain.                            |
| `api_key_auth` | ApiKeyAuth           |          | API key authentication for Freshdesk. Set exactly one auth method.                                        |
| `on_prem_auth` | OnPremiseAuth        |          | On-premise authentication through a Moveworks Agent running in your network. Set exactly one auth method. |

Set at most one of `api_key_auth`, `on_prem_auth`.

Example create body:

```json
{
  "name": "fresh_desk_connector",
  "system": "EXTERNAL_SYSTEM_FRESH_DESK",
  "fresh_desk_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_FRESH_SERVICE

Config block: `fresh_service_config`

Freshservice connection settings, used when system is EXTERNAL_SYSTEM_FRESH_SERVICE. Set exactly one system-specific config.

| Field          | Type                    | Required | Notes                                                                                                     |
| -------------- | ----------------------- | -------- | --------------------------------------------------------------------------------------------------------- |
| `standard_url` | StandardFreshServiceUrl |          | Base URL of your Freshservice instance, built from scheme, subdomain, and domain.                         |
| `api_key_auth` | ApiKeyAuth              |          | API key authentication for Freshservice. Set exactly one auth method.                                     |
| `on_prem_auth` | OnPremiseAuth           |          | On-premise authentication through a Moveworks Agent running in your network. Set exactly one auth method. |

Set at most one of `api_key_auth`, `on_prem_auth`.

Example create body:

```json
{
  "name": "fresh_service_connector",
  "system": "EXTERNAL_SYSTEM_FRESH_SERVICE",
  "fresh_service_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_GDRIVE

Config block: `gdrive_config`

Google Drive connection settings, used when system is EXTERNAL_SYSTEM_GDRIVE. Set exactly one system-specific config.

| Field                  | Type                     | Required | Notes                                                                                                                                                      |
| ---------------------- | ------------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `service_account_auth` | GDriveServiceAccountAuth |          | Google service account authentication without domain-wide delegation. Set exactly one auth method.                                                         |
| `oauth2_refresh`       | OAuth2RefreshToken       |          | OAuth 2.0 refresh token grant using the client ID, client secret, and refresh token from your Google Drive app's credentials. Set exactly one auth method. |

Set at most one of `service_account_auth`, `oauth2_refresh`.

Example create body:

```json
{
  "name": "gdrive_connector",
  "system": "EXTERNAL_SYSTEM_GDRIVE",
  "gdrive_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_GDRIVE_LEGACY

Config block: `gdrive_legacy_config`

Google Drive (legacy) connection settings, used when system is EXTERNAL_SYSTEM_GDRIVE_LEGACY. Set exactly one system-specific config.

| Field                  | Type                     | Required | Notes                                                                                                                                                |
| ---------------------- | ------------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `oauth2_refresh`       | OAuth2RefreshToken       |          | OAuth 2.0 refresh token grant using the client ID, client secret, and refresh token from your Google app's credentials. Set exactly one auth method. |
| `service_account_auth` | GdriveServiceAccountAuth |          | Google service account authentication. Set exactly one auth method.                                                                                  |
| `on_prem_auth`         | OnPremiseAuth            |          | On-premise authentication through a Moveworks Agent running in your network. Set exactly one auth method.                                            |

Set at most one of `oauth2_refresh`, `service_account_auth`, `on_prem_auth`.

Example create body:

```json
{
  "name": "gdrive_legacy_connector",
  "system": "EXTERNAL_SYSTEM_GDRIVE_LEGACY",
  "gdrive_legacy_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_GENESYS

Config block: `genesys_config`

Genesys connection settings, used when system is EXTERNAL_SYSTEM_GENESYS. Set exactly one system-specific config.

| Field                       | Type                    | Required | Notes                                                                                                                                                   |
| --------------------------- | ----------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `customer_region`           | string                  |          | Domain of your Genesys Cloud region, such as 'mypurecloud.com', 'mypurecloud.ie', 'mypurecloud.de', or 'usw2.pure.cloud'. Required. Checked when saved. |
| `oauth2_client_credentials` | OAuth2ClientCredentials |          | OAuth 2.0 client credentials using the client ID and client secret of your Genesys Cloud OAuth client.                                                  |

Example create body:

```json
{
  "name": "genesys_connector",
  "system": "EXTERNAL_SYSTEM_GENESYS",
  "genesys_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_GITHUB

Config block: `github_config`

GitHub connection settings, used when system is EXTERNAL_SYSTEM_GITHUB. Set exactly one system-specific config.

| Field             | Type   | Required | Notes                                                                                                                                |
| ----------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `installation_id` | string |          | Installation ID of the Moveworks GitHub App in your organization, used to request installation access tokens. At least 8 characters. |

Example create body:

```json
{
  "name": "github_connector",
  "system": "EXTERNAL_SYSTEM_GITHUB",
  "github_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_GLIA

Config block: `glia_config`

Glia connection settings, used when system is EXTERNAL_SYSTEM_GLIA. Set exactly one system-specific config.

| Field                       | Type                    | Required | Notes                                                                                                                         |
| --------------------------- | ----------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `standard_url`              | StandardGliaUrl         |          | Standard Glia base URL, built from scheme, subdomain, and domain. Set either this or custom_url.                              |
| `custom_url`                | CustomBaseUrl           |          | Custom base URL of your Glia instance. Use when your instance is not on the standard domain. Set either this or standard_url. |
| `oauth2_client_credentials` | OAuth2ClientCredentials |          | Glia API key authentication using an API key ID and API key secret. Set exactly one auth method.                              |
| `on_prem_auth`              | OnPremiseAuth           |          | On-premise authentication through a Moveworks Agent running in your network. Set exactly one auth method.                     |
| `service_credentials`       | OAuth2ClientCredentials |          | Glia service credentials using an API key ID and API key secret. Set exactly one auth method.                                 |

Example create body:

```json
{
  "name": "glia_connector",
  "system": "EXTERNAL_SYSTEM_GLIA",
  "glia_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_GSUITE

Config block: `gsuite_config`

Google Workspace (G Suite) connection settings, used when system is EXTERNAL_SYSTEM_GSUITE. Set exactly one system-specific config.

| Field                         | Type                            | Required | Notes                                                                                                             |
| ----------------------------- | ------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------- |
| `credentials`                 | string                          |          | Google credentials JSON file used to connect to Google Workspace. Secret: always returned masked as \*\*\*\*\*.   |
| `customer_id`                 | string                          |          | Your Google Workspace customer ID.                                                                                |
| `service_account_credentials` | GsuiteServiceAccountCredentials |          | Google service account credentials, optionally with domain-wide delegation. Set either this or oauth_credentials. |
| `oauth_credentials`           | GsuiteOAuthCredentials          |          | OAuth 2.0 credentials from your Google Cloud app. Set either this or service_account_credentials.                 |

Set at most one of `service_account_credentials`, `oauth_credentials`.

Example create body:

```json
{
  "name": "gsuite_connector",
  "system": "EXTERNAL_SYSTEM_GSUITE",
  "gsuite_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_GURU

Config block: `guru_config`

Guru connection settings, used when system is EXTERNAL_SYSTEM_GURU. Set exactly one system-specific config.

| Field          | Type                | Required | Notes                                                                                                     |
| -------------- | ------------------- | -------- | --------------------------------------------------------------------------------------------------------- |
| `basic_auth`   | BasicAuthentication |          | Basic authentication with the username and password of a Guru account. Set exactly one auth method.       |
| `on_prem_auth` | OnPremiseAuth       |          | On-premise authentication through a Moveworks Agent running in your network. Set exactly one auth method. |

Set at most one of `basic_auth`, `on_prem_auth`.

Example create body:

```json
{
  "name": "guru_connector",
  "system": "EXTERNAL_SYSTEM_GURU",
  "guru_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_IGLOO

Config block: `igloo_config`

Igloo connection settings, used when system is EXTERNAL_SYSTEM_IGLOO. Set exactly one system-specific config.

| Field             | Type            | Required | Notes                                                                                                              |
| ----------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------ |
| `custom_base_url` | CustomBaseUrl   |          | Base URL of your Igloo instance.                                                                                   |
| `cookie_auth`     | IglooCookieAuth |          | Igloo session (cookie) authentication with a user account and an app ID and password. Set exactly one auth method. |
| `on_prem_auth`    | OnPremiseAuth   |          | On-premise authentication through a Moveworks Agent running in your network. Set exactly one auth method.          |

Set at most one of `cookie_auth`, `on_prem_auth`.

Example create body:

```json
{
  "name": "igloo_connector",
  "system": "EXTERNAL_SYSTEM_IGLOO",
  "igloo_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_INTERACT

Config block: `interact_config`

Interact connection settings, used when system is EXTERNAL_SYSTEM_INTERACT. Set exactly one system-specific config.

| Field                   | Type                | Required | Notes                                                                                                         |
| ----------------------- | ------------------- | -------- | ------------------------------------------------------------------------------------------------------------- |
| `custom_url`            | CustomBaseUrl       |          | Base URL of your Interact intranet.                                                                           |
| `tenant_id`             | string              |          | Your Interact tenant ID, sent with each request to identify your tenant.                                      |
| `oauth2_password_grant` | BasicAuthentication |          | OAuth 2.0 password grant using the username and password of an Interact account. Set exactly one auth method. |
| `on_prem_auth`          | OnPremiseAuth       |          | On-premise authentication through a Moveworks Agent running in your network. Set exactly one auth method.     |

Set at most one of `oauth2_password_grant`, `on_prem_auth`.

Example create body:

```json
{
  "name": "interact_connector",
  "system": "EXTERNAL_SYSTEM_INTERACT",
  "interact_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_IVANTI

Config block: `ivanti_config`

Ivanti connection settings, used when system is EXTERNAL_SYSTEM_IVANTI. Set exactly one system-specific config.

| Field             | Type          | Required | Notes                                                                                                     |
| ----------------- | ------------- | -------- | --------------------------------------------------------------------------------------------------------- |
| `custom_base_url` | CustomBaseUrl |          | Base URL of your Ivanti instance.                                                                         |
| `api_key_auth`    | ApiKeyAuth    |          | API key authentication for Ivanti. Set exactly one auth method.                                           |
| `on_prem_auth`    | OnPremiseAuth |          | On-premise authentication through a Moveworks Agent running in your network. Set exactly one auth method. |

Set at most one of `api_key_auth`, `on_prem_auth`.

Example create body:

```json
{
  "name": "ivanti_connector",
  "system": "EXTERNAL_SYSTEM_IVANTI",
  "ivanti_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_JIRA

Config block: `jira_config`

Jira connection settings, used when system is EXTERNAL_SYSTEM_JIRA. Set exactly one system-specific config.

| Field               | Type                | Required | Notes                                                                                              |
| ------------------- | ------------------- | -------- | -------------------------------------------------------------------------------------------------- |
| `cloud_id`          | string              |          | Your Atlassian Cloud ID, which uniquely identifies your Jira instance.                             |
| `user_consent_auth` | JiraUserConsentAuth |          | OAuth 2.0 user consent authentication using the client ID and client secret of your Atlassian app. |

Set at most one of `user_consent_auth`.

Example create body:

```json
{
  "name": "jira_connector",
  "system": "EXTERNAL_SYSTEM_JIRA",
  "jira_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_JIRA_LEGACY

Config block: `jira_legacy_config`

Jira (legacy) connection settings, used when system is EXTERNAL_SYSTEM_JIRA_LEGACY. Set exactly one system-specific config.

| Field                            | Type                | Required | Notes                                                                                                                                       |
| -------------------------------- | ------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `standard_url`                   | JiraStandardUrl     |          | Standard Jira Cloud base URL, built from scheme, subdomain, and domain. Set either this or custom_url.                                      |
| `custom_url`                     | CustomBaseUrl       |          | Custom base URL of your Jira instance, for example a Jira Server URL. Set either this or standard_url.                                      |
| `cloud_basic_auth`               | BasicAuthentication |          | Basic authentication for Jira Cloud with a username and password (API token). Set exactly one auth method.                                  |
| `server_basic_auth`              | BasicAuthentication |          | Basic authentication for Jira Server with a username and password. Set exactly one auth method.                                             |
| `on_prem_auth`                   | OnPremiseAuth       |          | On-premise authentication through a Moveworks Agent running in your network. Set exactly one auth method.                                   |
| `shared_secret`                  | string              |          | Secret used to sign the JWT sent to the Jira Cloud identity app. Secret: always returned masked as \*\*\*\*\*.                              |
| `gdpr_mode`                      | boolean             |          | If true, ticket assignees are set by account ID instead of name. Recommended on for Jira Cloud and off for Jira Server and on-premise auth. |
| `upload_attachments_as_activity` | boolean             |          | If true, attachments are added as ticket activity.                                                                                          |
| `auth_headers`                   | array\<AuthHeader>  |          | Additional authentication headers sent with requests to Jira, as key and value pairs.                                                       |

Example create body:

```json
{
  "name": "jira_legacy_connector",
  "system": "EXTERNAL_SYSTEM_JIRA_LEGACY",
  "jira_legacy_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_JIVE

Config block: `jive_config`

Jive connection settings, used when system is EXTERNAL_SYSTEM_JIVE. Set exactly one system-specific config.

| Field             | Type                | Required | Notes                                                                                                     |
| ----------------- | ------------------- | -------- | --------------------------------------------------------------------------------------------------------- |
| `custom_base_url` | CustomBaseUrl       |          | Base URL of your Jive instance.                                                                           |
| `basic_auth`      | BasicAuthentication |          | Basic authentication with the username and password of a Jive account. Set exactly one auth method.       |
| `on_prem_auth`    | OnPremiseAuth       |          | On-premise authentication through a Moveworks Agent running in your network. Set exactly one auth method. |

Set at most one of `basic_auth`, `on_prem_auth`.

Example create body:

```json
{
  "name": "jive_connector",
  "system": "EXTERNAL_SYSTEM_JIVE",
  "jive_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_LUMAPPS

Config block: `lumapps_config`

LumApps connection settings, used when system is EXTERNAL_SYSTEM_LUMAPPS. Set exactly one system-specific config.

| Field                       | Type                    | Required | Notes                                                                                                                      |
| --------------------------- | ----------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------- |
| `standard_url`              | StandardLumappsUrl      |          | Base URL of the LumApps API, built from scheme, subdomain, and domain.                                                     |
| `organization_id`           | string                  |          | Your LumApps organization ID. Required. Checked when saved.                                                                |
| `user_id`                   | string                  |          | ID of the LumApps user on whose behalf application tokens are requested. Required. Checked when saved.                     |
| `oauth2_client_credentials` | OAuth2ClientCredentials |          | OAuth 2.0 client credentials grant using the client ID and client secret of your LumApps app. Set exactly one auth method. |
| `on_prem_auth`              | OnPremiseAuth           |          | On-premise authentication through a Moveworks Agent running in your network. Set exactly one auth method.                  |

Set at most one of `oauth2_client_credentials`, `on_prem_auth`.

Example create body:

```json
{
  "name": "lumapps_connector",
  "system": "EXTERNAL_SYSTEM_LUMAPPS",
  "lumapps_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```

## EXTERNAL_SYSTEM_MANAGE_ENGINE

Config block: `manage_engine_config`

ManageEngine ServiceDesk connection settings, used when system is EXTERNAL_SYSTEM_MANAGE_ENGINE. Set exactly one system-specific config.

| Field            | Type                    | Required | Notes                                                                                                                                      |
| ---------------- | ----------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `standard_url`   | StandardManageEngineUrl |          | Standard ManageEngine base URL, built from scheme, subdomain, and domain. Set either this or custom_url.                                   |
| `custom_url`     | CustomBaseUrl           |          | Custom base URL of your ManageEngine instance. Use when your instance is not on the standard domain. Set either this or standard_url.      |
| `oauth2_refresh` | OAuth2RefreshToken      |          | OAuth 2.0 refresh token grant using the client ID, client secret, and refresh token of your ManageEngine app. Set exactly one auth method. |
| `on_prem_auth`   | OnPremiseAuth           |          | On-premise authentication through a Moveworks Agent running in your network. Set exactly one auth method.                                  |

Example create body:

```json
{
  "name": "manage_engine_connector",
  "system": "EXTERNAL_SYSTEM_MANAGE_ENGINE",
  "manage_engine_config": {},
  "version": {
    "change_description": "Initial version."
  }
}
```