---
title: "Create a new connection"
method: POST
path: "/connections/{owner}"
tags: ["connections"]
---

# Create a new connection

`POST /connections/{owner}`

Create a new virtual connection. For increased security, connection endpoints require an Enterprise Admin
Token. This token can be found under [Advanced Settings](https://data.world/settings/advanced).

## Path parameters

- `owner` string, required

## Query parameters

- `validate` boolean

## Request body

- ConnectionDto
  - `advancedProperties` object — Advanced properties
  - `credentials` DatabaseCredentials
    - `password` string — password
    - `user` string, required — user name
  - `database` string — Database/Schema Logical Name
  - `host` string — Database Host
  - `name` string — Connection name
  - `port` integer — Database Port
  - `properties` object — Properties such as auto commit, isolation level etc.
  - `sshTunnel` SshTunnel
    - `host` string, required — ssh tunnel host
    - `port` integer — Tunnel Port
    - `user` string, required — user name
    - `userKeyPair` boolean, required — whether authentication is required
  - `sslRequired` boolean — Is ssl required
  - `trustedServerCertificates` string — trusted server certificates
  - `type` 'ATHENA' | 'AZURESYNAPSE' | 'BIGQUERY' | 'DB2' | 'DENODO' | 'HIVE' | 'DATABRICKS' | 'INFOR_ION' | 'MYSQL' | 'ORACLE' | 'POSTGRESQL' | 'REDSHIFT' | 'SERVICENOW' | 'SNOWFLAKE' | 'SPARK' | 'SQLSERVER' | 'TABLEAU' — Database Type
  - `usePrivateKey` boolean — Should this connection use a private key?
  - `verifyServerCertificate` boolean — Should server certificate be verified

## Response `200`

Connection created successfully.

- CreateResponse
  - `message` string
  - `uri` string, uri, required

---

[API](https://skmtc.dev/data/apis/data-world-public-api.md) · [All operations](https://skmtc.dev/data/apis/data-world-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/data/data-world-public-api/revisions/0a0cb1f94dad/schema)