---
title: "Create a connection."
method: POST
path: "/connectors/connection/create"
tags: ["data"]
---

# Create a connection.

`POST /connectors/connection/create`

Creates a connection and returns the connection id and headers (fields) associated with the connection.

## Request body

- NexusRequest
  - `connectionId` string — connection id for the request -- if not provided, connection will be created
  - `connectionName` string — connection name for the request -- if not provided, "Source Type timestamp" will be set
  - `jobParams` NexusScheduledJobParams
  - `obfuscatedUser` string — obfuscated user. Generally auth0 id.
  - `params` unknown
  - `runNow` boolean — run the request immediately (only used when schedule is present, otherwise always runs)
  - `schedule` ScheduleSchedule
    - `config` unknown
    - `type` '' | 'daily' | 'weekly' | 'monthly'
  - `skipNotification` boolean — skip sending notifications, will send notifications by the default
  - `source` 'snowflake' | 'snowflakeSSO' | 'snowflakeLiveQuery' | 'snowflakeSSOLiveQuery' | 'google-analytics-data-api' | 'hubspot' | 'mysql' | 'postgres' | 'salesforce' | 'salesforceReport' | 'freshsales' | 'databricks' | 'databricksDeltaShare' | 'databricksLiveQuery' | 'bigquery' | 'awsathena' | 'awsredshift' | 'mssql' | 'clickhouse' | 'clickhouseLiveQuery'
  - `user` string — user id for user performing action.

## Response `200`

OK

- NexusConnectionCreationResponse
  - `Headers` object
  - `Id` string
  - `Success` boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.net/freshdesk/apis/gigasheet-api.md) · [All operations](https://skmtc.net/freshdesk/apis/gigasheet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/freshdesk/gigasheet-api/versions/d1e5cbb24557/schema)