Skip to main content
Before you can create a new connection we need a few prerequisites: an API Key and an Organization. For more information on these two items please review our quick start guide here. The last step of the quick start describes how to create a new connection, the POST body consists of:
  1. vendor - The Enum of the vendor product you want to connect to.
  2. credentials - The specific credential body for the vendor you are connecting to, this is not required for Oauth based connections.
  3. options - (Optional) Any additional options you want to pass to the connection, each vendor has different options available.
Since creating a connection requires you to have the correct combination of vendor, credentials, and options in the correct combination we have provided examples of each below.

​
VMS Connections

{
  "credentials": {
    "client_key": "<string>",
    "secret_key": "<string>"
  },
  "vendor": "TENABLE"
}

{
  "credentials": {
      "username": "test",
      "password": "pass",
  },
  "options": { # Optional not required
      "init_load_timestamp": "2021-01-01T00:00:00+00:00", # Timestamp to start the data pull from
  },
  "vendor": "QUALYS"
}

{
  "credentials": {
    "base_url": "https://api.url.com",
    "api_key": "api_key"
  },
  "vendor": "INSIGHTVM"
}

{
  "vendor": "MS_DEFENDER_VMS",
  "options": { # Optional not required
    "oauth2_redirect_urls": { # Overried the default redirect to Leen's splash page'
      "success": "https://myapp.com/success",
      "error": "https://myapp.com/error"
    }
  }
}
More info on our OAuth flow can be found here
{
  "credentials": {
    "base_url": "https://api.url.com",
    "api_token": "api_token"
  },
  "vendor": "SENTINELONE_VMS"
}

{
  "credentials": {
    "client_id": "client_id",
    "client_secret": "client_secret"
  },
  "vendor": "CROWDSTRIKE_SPOTLIGHT"
}

{
  "credentials": {
    "aws": {
      "aws_access_key_id": "access_key_id",
      "aws_secret_access_key": "secret_key",
      "aws_region_name": "us-east-1",
      "type": "direct_access"
    }
  },
  "vendor": "AWS_INSPECTOR2"
}

{
  "credentials": {
    "aws": {
      "aws_role_arn": "role_arn",
      "external_id": "external_id",
      "aws_region_name": "us-east-1",
      "type": "leen_role"
    }
  },
  "vendor": "AWS_INSPECTOR2"
}

{
  "credentials": {
    "aws": {
      "aws_role_arn": "role_arn",
      "external_id": "external_id",
      "aws_region_name": "us-east-1",
      "type": "role_chaining"
    }
  },
  "vendor": "AWS_INSPECTOR2"
}

{
  "credentials": {
    "base_url": "https://api.usxx.app.wiz.io",
    "client_id": "client_id",
    "client_secret": "client_secret"
  },
  "vendor": "WIZ_VMS"
}

​
EDR Connections

{
  "vendor": "MS_DEFENDER_ENDPOINT",
  "options": { # Optional not required
    "oauth2_redirect_urls": { # Overried the default redirect to Leen's splash page'
      "success": "https://myapp.com/success",
      "error": "https://myapp.com/error"
    }
  }
}
More info on our OAuth flow can be found here
{
  "credentials": {
    "base_url": "https://api.url.com",
    "api_token": "api_token"
    },
    "vendor": "SENTINELONE"
}

{
  "credentials": {
    "client_id": "client_id",
    "client_secret": "client_secret"
  },
  "vendor": "CROWDSTRIKE"
}

​
AppSec Connections

{
    "vendor": "SNYK",
    "options": { # Optional not required
        "oauth2_redirect_urls": { # Overried the default redirect to Leen's splash page'
          "success": "https://myapp.com/success",
          "error": "https://myapp.com/error"
        }
    }
}
More info on our OAuth flow can be found here
{
  "vendor": "SEMGREP",
  "credentials": {
    "web_api_token": "web_api_token"
  }
}

{
  "vendor": "AIKIDO",
  "credentials": {
    "client_id": "client_id",
    "client_secret": "client_secret",
  }
}

{
  "credentials": {
    "base_url": "https://api.usxx.app.wiz.io",
    "client_id": "client_id",
    "client_secret": "client_secret"
  },
  "vendor": "WIZ_CODE"
}

{
  "credentials": {
    "base_url": "https://us.ast.checkmarx.net",
    "tenant_name": "tenant-name",
    "client_id": "client_id",
    "client_secret": "client_secret"
  },
  "vendor": "CHECKMARX"
}

{
  "credentials": {
    "user_email": "user-email",
    "user_key": "user-key",
    "org_uuid": "org-uuid",
    "base_url": "https://api-saas.mend.io"
  }
  "vendor": "MEND"
},

​
IDP Connections

{
    "vendor": "OKTA",
    "credentials": {
      "org_url": "https://{your-tenant}.okta.com",
      "api_token": "api_token"
    }
}

{
  "vendor": "MS_ENTRA",
  "options": { # Optional not required
    "oauth2_redirect_urls": { # Overried the default redirect to Leen's splash page'
      "success": "https://myapp.com/success",
      "error": "https://myapp.com/error"
    }
  }
}
More info on our OAuth flow can be found here
{
  "vendor": "MS_ENTRA",
  "credentials": {
    "client_id": "client_id",
    "client_secret": "client_secret",
    "tenant_id": "tenant_id"
  }
}
⌘I