---
title: "Create a New Department"
method: POST
path: "/v1/departments"
tags: ["Departments"]
---

# Create a New Department

`POST /v1/departments`

You may create a Department using this action. It takes a JSON object containing a Department.

## Request body

- object
  - `name` string, required — A name for the Department. This may be displayed publicly on Credentials.
  - `description` string — A description for the Department. This may be displayed publicly.
  - `url` string, required — URL for directing users to the website for the given Department. This may be used publicly.
  - `logo` string, required — URL of an image representing the Department logo. Accredible will copy the given image and store the logo within it's own platform. Images should be square, at least 120px wide by 120px tall. PNG format preferred.
  - `page_banner` string — URL of an image to display as the Department Banner. Accredible will copy the given image and store the logo within it's own platform. The image should be at least 1920px wide by 300px tall. PNG format preferred.
  - `whitelabel_logo` string — URL of an image to display in the header and footer of the white-labeled recipient website. The image should be at least 208px wide by 32px tall. PNG format preferred.
  - `linkedin_company_id` string — The LinkedIn company ID for the given 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.
  - `generate_private_credential` boolean — This boolean value will be used as the default of `Credential.private` when creating a new Credential unless it's overridden by `Group.generate_private_credential` that is set to `true` or `false`.

## Response `200`

OK

- object
  - `department` object
    - `id` number
    - `name` string
    - `description` string
    - `url` string
    - `logo` string
    - `page_banner` string
    - `whitelabel_logo` string
    - `linkedin_company_id` string
    - `meta_data` object
      - `internal_id` string
      - `faculty` string
    - `generate_private_credential` boolean

---

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