---
title: "Create a data source."
method: POST
path: "/datasources"
tags: ["datasources"]
---

# Create a data source.

`POST /datasources`

By defining `password` and `basicAuthPassword` under secureJsonData property
Grafana encrypts them securely as an encrypted blob in the database.
The response then lists the encrypted fields under secureJsonFields.

If you are running Grafana Enterprise and have Fine-grained access control enabled
you need to have a permission with action: `datasources:create`

## Request body

- AddDataSourceCommand — Also acts as api DTO
  - `access` string
  - `basicAuth` boolean
  - `basicAuthUser` string
  - `database` string
  - `isDefault` boolean
  - `jsonData` Json
  - `name` string
  - `secureJsonData` object
  - `type` string
  - `uid` string
  - `url` string
  - `user` string
  - `withCredentials` boolean

## Response `200`

(empty)

- object
  - `datasource` DataSource, required
    - `access` string
    - `accessControl` Metadata — Metadata contains user accesses for a given resource Ex: map[string]bool{"create":true, "delete": true}
    - `basicAuth` boolean
    - `basicAuthUser` string
    - `database` string
    - `id` integer
    - `isDefault` boolean
    - `jsonData` Json
    - `name` string
    - `orgId` integer
    - `readOnly` boolean
    - `secureJsonFields` object
    - `type` string
    - `typeLogoUrl` string
    - `uid` string
    - `url` string
    - `user` string
    - `version` integer
    - `withCredentials` boolean
  - `id` integer, required — ID Identifier of the new data source.
  - `message` string, required — Message Message of the deleted dashboard.
  - `name` string, required — Name of the new data source.

## Other responses

- `401` — UnauthorizedError is returned when the request is not authenticated.
- `403` — ForbiddenError is returned if the user/token has insufficient permissions to access the requested resource.
- `409` — ConflictError
- `500` — InternalServerError is a general error indicating something went wrong internally.

---

[API](https://skmtc.net/grafana/apis/http-api.md) · [All operations](https://skmtc.net/grafana/apis/http-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grafana/http-api/revisions/df55ba1718ba/schema)