---
title: "Create a Design"
method: POST
path: "/v1/designs"
tags: ["Designs"]
---

# Create a Design

`POST /v1/designs`

## Request body

- object
  - `name` string, required — Name of the Design (for your reference and never shown to the recipient).
  - `kind` string, required — Must be "certificate" or "badge" to specify the Design type.
  - `encoded_content` string, required — The encoded content of the design.
  - `background_bleeds` boolean — Specifies if the design should allow print bleeding.
  - `orientation` string — Must be "landscape" or "portrait" to specify a design's paper orientation.
  - `size` string — Must be "us-letter" or "a4" to specify a design's paper size.
  - `department_id` number — Department that the Design belongs to. If not defined the Design will be assigned to the organizations default department.
  - `meta_data` object — You can use this parameter to attach key-value strings to the object. Meta data is useful for storing additional, structured information on an object.

## Response `200`

OK

## Changes

- **2025-06-30** `98201e8dd1b4` — 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `ApiKeyAuth` was added to the API

[Change history](https://skmtc.dev/accredible/apis/accredible-credential-api/changes/v1/designs/post.md)

---

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