> ## Documentation Index
> Fetch the complete documentation index at: https://developers.concord.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Create consent type

> Create a new consent type in a project.



## OpenAPI

````yaml https://api.concord.tech/docs/json/privacy-v1/ post /organizations/{organizationId}/projects/{projectId}/consent-types
openapi: 3.1.0
info:
  title: Concord Privacy API
  description: >-
    The Concord Privacy API provide full access to the Concord platform for
    registered organizations.
  version: 3.29.6
  contact:
    email: support@concord.tech
    name: Concord Technologies Inc.
    url: https://www.concord.tech
  license:
    name: Proprietary
    url: https://www.concord.tech/legal/saas-agreement
  termsOfService: https://www.concord.tech/legal/saas-agreement
servers:
  - url: https://api.concord.tech/privacy-v1
    description: Concord Privacy API
security:
  - ApiKeyAuth: []
tags:
  - name: API Keys
    description: API Key endpoints.
  - name: Consent Events
    description: Consent event endpoints.
  - name: Consent Types
    description: Consent type endpoints.
  - name: Compliance Requests
    description: Compliance request endpoints.
  - name: Data Systems
    description: Data System endpoints.
  - name: Domains
    description: Domain endpoints.
  - name: Emails
    description: Emails endpoints.
  - name: GCM Scans
    description: GCM Scan endpoints.
  - name: Health Check
    description: Health Check endpoints.
  - name: Metrics
    description: Metrics endpoints.
  - name: Permissions
    description: Permission endpoints.
  - name: Policies
    description: Policy endpoints.
  - name: Projects
    description: Project endpoints.
  - name: Languages
    description: Language endpoints.
  - name: Organizations
    description: Organization endpoints.
  - name: Regions
    description: Region template endpoints.
  - name: Sessions
    description: Session endpoints.
  - name: Trackers
    description: Tracker endpoints.
  - name: Tracker Scans
    description: Tracker Scan endpoints.
  - name: Users
    description: Users endpoints.
  - name: Subscriptions
    description: Subscription endpoints.
paths:
  /organizations/{organizationId}/projects/{projectId}/consent-types:
    post:
      tags:
        - Consent Types
      summary: Create consent type
      description: Create a new consent type in a project.
      operationId: >-
        post_privacy_v1_organizations_organizationid_projects_projectid_consent_types
      parameters:
        - schema:
            type: string
            format: uuid
          in: path
          name: organizationId
          required: true
        - schema:
            type: string
            format: uuid
          in: path
          name: projectId
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                category:
                  anyOf:
                    - type: string
                      enum:
                        - disclosure
                        - communication
                        - privacy_setting
                        - custom
                      maxLength: 128
                    - type: string
                      maxLength: 128
                      pattern: ^custom_[a-z0-9_]{1,121}$
                subcategory:
                  oneOf:
                    - type: array
                      items: {}
                    - type: boolean
                    - type: number
                    - type: object
                    - type: string
                label:
                  type: string
                  maxLength: 128
                  pattern: '[a-z0-9_*]{1,128}$'
                name:
                  type: string
                  minLength: 5
                  maxLength: 100
                description:
                  type: string
                  maxLength: 2000
                document:
                  type: string
                  maxLength: 5000000
                url:
                  type: string
                  format: uri
                validStates:
                  type: array
                  items:
                    type: string
                    enum:
                      - implied
                      - viewed
                      - accepted
                      - declined
                consentDuration:
                  type: string
                  format: duration
                status:
                  type: string
                  default: active
                  enum:
                    - active
                    - test
                    - archived
                required:
                  type: boolean
                  default: false
                requireReaccept:
                  type: boolean
                  default: false
              required:
                - category
                - subcategory
                - label
              additionalProperties: false
        required: true
      responses:
        '201':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  createdAt:
                    oneOf:
                      - type: array
                        items: {}
                      - type: boolean
                      - type: number
                      - type: object
                      - type: string
                  updatedAt:
                    oneOf:
                      - type: array
                        items: {}
                      - type: boolean
                      - type: number
                      - type: object
                      - type: string
                  id:
                    type: string
                    format: uuid
                  organization:
                    anyOf:
                      - type: string
                        format: uuid
                      - type: object
                        properties:
                          id:
                            type: string
                            format: uuid
                          name:
                            type: string
                        additionalProperties: false
                  project:
                    anyOf:
                      - type: string
                        format: uuid
                      - type: object
                        properties:
                          id:
                            type: string
                            format: uuid
                          name:
                            type: string
                        additionalProperties: false
                  category:
                    anyOf:
                      - type: string
                        enum:
                          - disclosure
                          - communication
                          - privacy_setting
                          - custom
                        maxLength: 128
                      - type: string
                        maxLength: 128
                        pattern: ^custom_[a-z0-9_]{1,121}$
                  subcategory:
                    oneOf:
                      - type: array
                        items: {}
                      - type: boolean
                      - type: number
                      - type: object
                      - type: string
                  label:
                    type: string
                    maxLength: 128
                    pattern: '[a-z0-9_*]{1,128}$'
                  version:
                    type: integer
                  dateCreated:
                    type: string
                    format: date-time
                  dateUpdated:
                    type: string
                    format: date-time
                  name:
                    type: string
                    maxLength: 100
                  description:
                    type: string
                    maxLength: 2000
                  document:
                    type: string
                    maxLength: 5000000
                  url:
                    type: string
                    format: uri
                  readOnly:
                    type: boolean
                    default: false
                  validStates:
                    type: array
                    items:
                      type: string
                      enum:
                        - implied
                        - viewed
                        - accepted
                        - declined
                  status:
                    type: string
                    enum:
                      - active
                      - archived
                      - obsolete
                      - test
                  consentDuration:
                    type: string
                  required:
                    type: boolean
                    default: false
                  requireReacceptVersion:
                    type: integer
                required:
                  - id
                  - project
                  - version
                  - name
                  - description
                additionalProperties: false
        '400':
          description: Bad request response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    format: int32
                    default: 404
                    description: The status code of the request.
                  error:
                    type: string
                    default: Not Found
                    description: The error string for the status code.
                  message:
                    type: string
                    description: Description of the error encounted.
                required:
                  - statusCode
                  - error
                  - message
        '401':
          description: Unauthorized response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    format: int32
                    default: 404
                    description: The status code of the request.
                  error:
                    type: string
                    default: Not Found
                    description: The error string for the status code.
                  message:
                    type: string
                    default: Forbidden
                required:
                  - statusCode
                  - error
                  - message
        '403':
          description: Forbidden response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    format: int32
                    default: 403
                    description: The status code of the request.
                  error:
                    type: string
                    default: Forbidden
                  message:
                    type: string
                    default: Forbidden
                required:
                  - statusCode
                  - error
                  - message
        '404':
          description: Not found response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    format: int32
                    default: 404
                  error:
                    type: string
                    default: Not Found
                  message:
                    type: string
                    default: Not Found
                required:
                  - statusCode
                  - error
                  - message
        '422':
          description: Unprocessable Entity response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    format: int32
                    default: 422
                  error:
                    type: string
                    default: Unprocessable Entity
                  message:
                    type: string
                    description: Description of the error encounted.
                required:
                  - statusCode
                  - error
                  - message
        '500':
          description: Internal server error response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    format: int32
                    default: 500
                  error:
                    type: string
                    default: Internal Server Error
                  message:
                    type: string
                    default: Internal Server Error
                    description: Will always be "Internal Server Error"
                required:
                  - statusCode
                  - error
                  - message
components:
  securitySchemes:
    ApiKeyAuth:
      name: x-api-key
      type: apiKey
      in: header
      description: ''

````