Lists the predefined connector presets available to the workspace.

GET

https://api.awork.com/api/v1/agents/connectors/presets

GET

/api/v1/agents/connectors/presets

curl https://api.awork.com/api/v1/agents/connectors/presets \
     -H "Authorization: Bearer <token>"

{
  "presets": [
    {
      "hasConfiguration": false,
      "key": "hubspot",
      "name": "HubSpot",
      "logoPath": "images/integrations/hubspot_icon.svg",
      "supportsDynamicClientRegistration": false,
      "requiresOAuthClientSecret": false,
      "documentationUrl": "https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server",
      "isDisabled": false,
      "managedOAuthProviderKey": "hubspot",
      "showOAuthCredentials": false,
      "companySearch": {
        "enabled": true,
        "toolName": "search_companies",
        "queryParameterName": "query"
      },
      "endpointFields": [
        {
          "key": "subdomain",
          "controlType": "text",
          "labelKey": "subdomain",
          "placeholderKey": "subdomain",
          "validationKind": "hostLabel",
          "isRequired": true,
          "defaultValue": "northstar-agency",
          "maxLength": 63,
          "options": [
            {
              "value": "eu",
              "labelKey": "eu"
            }
          ]
        }
      ]
    }
  ],
  "oauthCallbackUri": "https://app.awork.com/api/v1/agents/connectors/auth/callback"
}

Lists predefined connector presets and the OAuth callback URI used for connector setup. Create connectors in the awork app. The response describes setup options; it does not create a connector.

Required Permissions

Any authenticated user.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

includeAddedbooleanOptionalDefaults to false

Whether to include providers already added to the workspace for metadata lookup.

Response

presetslist of objects or nullOptional

The predefined connector presets.

oauthCallbackUristring or nullOptional

The OAuth callback URI to register with OAuth providers.

Errors

401

Unauthorized Error