---
title: "Create new data source"
method: POST
path: "/sources"
tags: ["sources"]
---

# Create new data source

`POST /sources`

## Request body

- Source
  - `id` string — Unique identifier representing a specific data source.
  - `name` string — User facing name of data source
  - `type` 'influx' | 'influx-enterprise' | 'influx-relay' | 'influx-v2' | 'influx-v3-core' | 'influx-v3-enterprise' | 'influx-v3-clustered' | 'influx-v3-cloud-dedicated' | 'influx-v3-serverless' — Format of the data source
  - `username` string — Username for authentication to data source
  - `password` string — Password is in cleartext.
  - `sharedSecret` string — JWT signing secret for optional Authorization: Bearer to InfluxDB
  - `clusterId` string — Cluster ID for InfluxDB Cloud Dedicated sources
  - `accountId` string — Account ID for InfluxDB Cloud Dedicated sources
  - `managementToken` string — Management token for InfluxDB Cloud Dedicated sources
  - `databaseToken` string — Database token for InfluxDB Cloud Dedicated or other InfluxDB 3 sources
  - `tagsCSVPath` string — Path to a directory containing CSV files with tags for InfluxDB Cloud Dedicated sources
  - `url` string, url, required — URL for the time series data source backend (e.g. http://localhost:8086)
  - `metaUrl` string, url — URL for the influxdb meta node
  - `insecureSkipVerify` boolean — True means any certificate presented by the source is accepted. Typically used for self-signed certs. Probably should only be used for testing.
  - `default` boolean — Indicates whether this source is the default source
  - `telegraf` string — Database where telegraf information is stored for this source
  - `defaultRP` string — Default retention policy used in Host-related queries proxied to InfluxDB from the Host List and Host pages.
  - `defaultDB` string — Default database used in queries for InfluxDB Cloud Dedicated when database list is not available
  - `organization` string — Organization that this source belongs to, when Chronograf auth is in use
  - `role` string — Not used currently. Can be used to designate a minimum role required to access this source.
  - `version` string — Version of influxDB being run, unknown if not found
  - `links` object
    - `self` string, url — Self link mapping to this resource
    - `proxy` string, url — URL location of proxy endpoint for this source
    - `write` string, url — URL location of write endpoint for this source
    - `queries` string, url — URL location of the queries endpoint for this source
    - `kapacitors` string, url — URL location of the kapacitors endpoint for this source
    - `users` string, url — URL location of the users endpoint for this source
    - `permissions` string, url — URL location of the permissions endpoint for this source
    - `roles` string, url — Optional path to the roles endpoint IFF it is supported on this source
    - `health` string, url — Path to determine if source is healthy

## Response `201`

Data source successfully created

- Source
  - `id` string — Unique identifier representing a specific data source.
  - `name` string — User facing name of data source
  - `type` 'influx' | 'influx-enterprise' | 'influx-relay' | 'influx-v2' | 'influx-v3-core' | 'influx-v3-enterprise' | 'influx-v3-clustered' | 'influx-v3-cloud-dedicated' | 'influx-v3-serverless' — Format of the data source
  - `username` string — Username for authentication to data source
  - `password` string — Password is in cleartext.
  - `sharedSecret` string — JWT signing secret for optional Authorization: Bearer to InfluxDB
  - `clusterId` string — Cluster ID for InfluxDB Cloud Dedicated sources
  - `accountId` string — Account ID for InfluxDB Cloud Dedicated sources
  - `managementToken` string — Management token for InfluxDB Cloud Dedicated sources
  - `databaseToken` string — Database token for InfluxDB Cloud Dedicated or other InfluxDB 3 sources
  - `tagsCSVPath` string — Path to a directory containing CSV files with tags for InfluxDB Cloud Dedicated sources
  - `url` string, url, required — URL for the time series data source backend (e.g. http://localhost:8086)
  - `metaUrl` string, url — URL for the influxdb meta node
  - `insecureSkipVerify` boolean — True means any certificate presented by the source is accepted. Typically used for self-signed certs. Probably should only be used for testing.
  - `default` boolean — Indicates whether this source is the default source
  - `telegraf` string — Database where telegraf information is stored for this source
  - `defaultRP` string — Default retention policy used in Host-related queries proxied to InfluxDB from the Host List and Host pages.
  - `defaultDB` string — Default database used in queries for InfluxDB Cloud Dedicated when database list is not available
  - `organization` string — Organization that this source belongs to, when Chronograf auth is in use
  - `role` string — Not used currently. Can be used to designate a minimum role required to access this source.
  - `version` string — Version of influxDB being run, unknown if not found
  - `links` object
    - `self` string, url — Self link mapping to this resource
    - `proxy` string, url — URL location of proxy endpoint for this source
    - `write` string, url — URL location of write endpoint for this source
    - `queries` string, url — URL location of the queries endpoint for this source
    - `kapacitors` string, url — URL location of the kapacitors endpoint for this source
    - `users` string, url — URL location of the users endpoint for this source
    - `permissions` string, url — URL location of the permissions endpoint for this source
    - `roles` string, url — Optional path to the roles endpoint IFF it is supported on this source
    - `health` string, url — Path to determine if source is healthy

## Other responses

- `default` — A processing or an unexpected error.

---

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