> ## 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 event(s)

> Create new consent event(s) in a project.



## OpenAPI

````yaml https://api.concord.tech/docs/json/privacy-v1/ post /organizations/{organizationId}/projects/{projectId}/consent-events
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-events:
    post:
      tags:
        - Consent Events
      summary: Create consent event(s)
      description: Create new consent event(s) in a project.
      operationId: >-
        post_privacy_v1_organizations_organizationid_projects_projectid_consent_events
      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:
                items:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      projectUserId:
                        type: string
                      userId:
                        type: string
                      email:
                        type: string
                        format: email
                      phoneNumber:
                        type: string
                      concordId:
                        type: string
                        format: uuid
                      consentType:
                        type: string
                        format: uuid
                      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
                        pattern: ^[a-z0-9_]{1,36}$
                      consentState:
                        type: string
                        enum:
                          - implied
                          - viewed
                          - accepted
                          - declined
                      consentAction:
                        type: string
                        enum:
                          - implied
                          - user_click
                          - import
                      consentDate:
                        type: string
                        format: date-time
                      expirationDate:
                        type: string
                        format: date-time
                    required:
                      - consentState
                      - consentAction
                    additionalProperties: false
                    allOf:
                      - anyOf:
                          - required:
                              - concordId
                          - required:
                              - email
                          - required:
                              - phoneNumber
                          - required:
                              - projectUserId
                          - required:
                              - userId
              required:
                - items
              additionalProperties: false
        required: true
      responses:
        '201':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: number
                  items:
                    type: array
                    items:
                      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
                        concordId:
                          type: string
                          format: uuid
                        consentAction:
                          type: string
                          enum:
                            - implied
                            - user_click
                            - import
                        consentDate:
                          type: string
                          format: date-time
                        consentState:
                          type: string
                          enum:
                            - implied
                            - viewed
                            - accepted
                            - declined
                        dateCreated:
                          type: string
                          format: date-time
                        dateUpdated:
                          type: string
                          format: date-time
                        consentType:
                          anyOf:
                            - type: string
                              format: uuid
                            - 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
                        expirationDate:
                          type: string
                          format: date-time
                        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
                        session:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                            ipAddress:
                              type: string
                              format: ipv4
                            domain:
                              anyOf:
                                - enum:
                                    - localhost
                                - type: string
                            geography:
                              type: string
                            userAgent:
                              type: string
                          additionalProperties: false
                        submitter:
                          type: string
                          format: uuid
                        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
                      required:
                        - id
                        - concordId
                        - consentAction
                        - consentDate
                        - consentState
                        - expirationDate
                      additionalProperties: false
                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: ''

````