---
title: "Create Design"
method: POST
path: "/tenants/{tenant_id}/designs"
tags: ["Designs"]
---

# Create Design

`POST /tenants/{tenant_id}/designs`

Create a new design for a project.

---

The returned design ID allows you to create a deep link into the Aurora application. That way, you can direct users to a specific design within a specific project. Please note, a design must always belong to a project. Therefore the `project_id` must always be provided.

## Path parameters

- `tenant_id` string, uuid, required

## Request body

- object
  - `design` object — Design to create.
    - `external_provider_id` string — Unique ID of design provided by external provider.
    - `project_id` string, uuid, required — Unique ID identifying the project that this design belongs to.
    - `name` string, required — Name of the design.

## Response `200`

Design successfully created.

- object
  - `design` object
    - `id` string, uuid — Unique ID identifying the design.
    - `external_provider_id` string — Unique ID of design provided by external provider.
    - `project_id` string, uuid — Unique ID identifying the project that this design belongs to.
    - `name` string — Name of the design.
    - `design_request_id` string, uuid — For designs created via a [design request](https://docs.aurorasolar.com/reference/design-requests), unique ID for the design request.
    - `created_at` string, date-time — The timestamp of when the design was created in UTC.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity

---

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