> ## Documentation Index > Fetch the complete documentation index at: https://formbricks.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create a response > Creates a response in the database. This will trigger the response pipeline, including webhooks, integrations, follow-up emails, and other configured actions. ## OpenAPI ````yaml /api-v2-reference/openapi.yml post /management/responses openapi: 3.1.0 info: title: Formbricks API description: Manage Formbricks resources programmatically. version: 2.0.0 servers: - url: https://app.formbricks.com/api/v2 description: Formbricks Cloud security: - apiKeyAuth: [] tags: - name: Health description: Operations for checking critical application dependencies health status. - name: Roles description: Operations for managing roles. - name: Me description: Operations for managing your API key. - name: Management API - Responses description: Operations for managing responses. - name: Management API - Contacts description: Operations for managing contacts. - name: Management API - Contact Attributes description: Operations for managing contact attributes. - name: Management API - Contact Attribute Keys description: Operations for managing contact attribute keys. - name: Management API - Surveys description: Operations for managing surveys. - name: Management API - Surveys - Contact Links description: Operations for generating personalized survey links for contacts. - name: Management API - Webhooks description: Operations for managing webhooks. - name: Organizations API - Teams description: Operations for managing teams. - name: Organizations API - Project Teams description: Operations for managing project teams. - name: Organizations API - Users description: Operations for managing users. paths: /management/responses: post: tags: - Management API - Responses summary: Create a response description: >- Creates a response in the database. This will trigger the response pipeline, including webhooks, integrations, follow-up emails, and other configured actions. operationId: createResponse requestBody: required: true description: The response to create content: application/json: schema: type: object properties: createdAt: type: string description: The date and time the response was created example: '2021-01-01T00:00:00.000Z' updatedAt: type: string description: The date and time the response was last updated example: '2021-01-01T00:00:00.000Z' surveyId: type: string description: The ID of the survey displayId: type: - string - 'null' description: The display ID of the response singleUseId: type: - string - 'null' description: The single use ID of the response finished: type: boolean description: Whether the response is finished example: true endingId: type: - string - 'null' description: The ID of the ending language: type: - string - 'null' description: The language of the response example: en data: type: object additionalProperties: anyOf: - type: string - type: number - type: array items: type: string - type: object additionalProperties: type: string description: The data of the response example: question1: answer1 question2: 2 question3: - answer3 - answer4 question4: subquestion1: answer5 variables: type: object additionalProperties: anyOf: - type: string - type: number description: The variables of the response example: variable1: answer1 variable2: 2 ttc: type: object additionalProperties: type: number description: The TTC of the response example: question1: 10 question2: 20 meta: type: object properties: source: type: string description: The source of the response example: https://example.com url: type: string description: The URL of the response example: https://example.com userAgent: type: object properties: browser: type: string os: type: string device: type: string country: type: string action: type: string description: The meta data of the response example: source: https://example.com url: https://example.com userAgent: browser: Chrome os: Windows device: Desktop country: US action: click userId: type: string required: - surveyId - finished - data responses: '201': description: Response created successfully. content: application/json: schema: type: object properties: id: type: string description: The ID of the response createdAt: type: string description: The date and time the response was created example: '2021-01-01T00:00:00.000Z' updatedAt: type: string description: The date and time the response was last updated example: '2021-01-01T00:00:00.000Z' finished: type: boolean description: Whether the response is finished example: true surveyId: type: string description: The ID of the survey contactId: type: - string - 'null' description: The ID of the contact endingId: type: - string - 'null' description: The ID of the ending data: type: object additionalProperties: anyOf: - type: string - type: number - type: array items: type: string - type: object additionalProperties: type: string description: The data of the response example: question1: answer1 question2: 2 question3: - answer3 - answer4 question4: subquestion1: answer5 variables: type: object additionalProperties: anyOf: - type: string - type: number description: The variables of the response example: variable1: answer1 variable2: 2 ttc: type: object additionalProperties: type: number description: The TTC of the response example: question1: 10 question2: 20 meta: type: object properties: source: type: string description: The source of the response example: https://example.com url: type: string description: The URL of the response example: https://example.com userAgent: type: object properties: browser: type: string os: type: string device: type: string country: type: string action: type: string description: The meta data of the response example: source: https://example.com url: https://example.com userAgent: browser: Chrome os: Windows device: Desktop country: US action: click contactAttributes: type: - object - 'null' additionalProperties: type: string description: The attributes of the contact example: attribute1: value1 attribute2: value2 singleUseId: type: - string - 'null' description: The single use ID of the response language: type: - string - 'null' description: The language of the response example: en displayId: type: - string - 'null' description: The display ID of the response components: securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: Use your Formbricks x-api-key to authenticate. ````