---
title: "Create new visualization"
method: POST
path: "/charts"
---

# Create new visualization

`POST /charts`

Requires scope `chart:write`.

## Request body

- object
  - `title` string — Title of your visualization. This will be the visualization headline.
  - `theme` string — Chart theme to use.
  - `type` string — Type of the chart ([Reference](https://developer.datawrapper.de/v3.0/docs/chart-types))
  - `forkable` boolean — Set to true if you want to allow other users to fork this visualization
  - `workspace` string — Slug of the workspace that the visualization should be created in. The authenticated user must have access to this workspace.
  - `organizationId` string — ID of the team (formerly known as organization) that the visualization should be created in. The authenticated user must have access to this team.
  - `folderId` integer — ID of the folder that the visualization should be created in. The authenticated user must have access to this folder.
  - `externalData` string — URL of external dataset
  - `language` string — Visualization locale (e.g. en-US)
  - `lastEditStep` integer — Current position in chart editor workflow
  - `metadata` object — Metadata that saves all visualization specific settings and options.
    - `axes` object — Mapping of dataset columns to visualization "axes"
    - `data` object
      - `transpose` boolean
    - `describe` object
      - `intro` string — The visualization description
      - `byline` string — Byline as shown in the visualization footer
      - `source-name` string — Source as shown in visualization footer
      - `source-url` string — Source URL as shown in visualization footer
      - `aria-description` string — Alternative description of visualization shown in screen readers (instead of the visualization)
    - `annotate` object
      - `notes` string — Notes as shown underneath visualization
    - `publish` object
    - `custom` object

## Response `200`

Successful

---

[API](https://skmtc.dev/datawrapper/apis/datawrapper-api-v3-documentation.md) · [All operations](https://skmtc.dev/datawrapper/apis/datawrapper-api-v3-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/datawrapper/datawrapper-api-v3-documentation/revisions/e190512863c7/schema)