---
title: "Create a new widget"
method: POST
path: "/intelligent-sales-rooms/{salesRoomId}/widgets"
tags: ["Intelligent Sales Room"]
---

# Create a new widget

`POST /intelligent-sales-rooms/{salesRoomId}/widgets`

Creates a new user-generated widget with type-specific content structure.

Content format by widget type:
- RICH_TEXT: {"html": "HTML content"}
- AI_GENERATED_TEXT: {} (empty object - content is generated by calling the AI generation endpoint after widget creation)
- MEDIA_CONTENT: {"type": "YOUTUBE_VIDEO|LINK|FILE_UPLOAD|GOOGLE_WORKSPACE|PDF_UPLOAD", "url": "...", "fileId": "...", "title": "..."}
- USER_PDF: {"fileId": "uploaded-file-uuid"}

Media content types:
- YOUTUBE_VIDEO: YouTube video URLs
- LINK: Generic web links
- FILE_UPLOAD: References uploaded files via fileId
- GOOGLE_WORKSPACE: Google Docs/Sheets/Slides URLs
- PDF_UPLOAD: References uploaded PDF files via fileId

AI Generated content structure after generation:
- type: "AI_GENERATED_TEXT"
- aiContentId: UUID of the generated content record
- displayContent: The actual generated text content

## Path parameters

- `salesRoomId` string, required

## Request body

- IntelligentSalesRoomCreateWidgetRequest
  - `name` string
  - `type` 'ORDER_FORM_PDF' | 'CUSTOMER_INFORMATION' | 'ADDITIONAL_INFORMATION' | 'E_SIGNATURE_BUTTON' | 'ACCEPT_PROPOSAL_BUTTON' | 'MEDIA_CONTENT' | 'RICH_TEXT' | 'AI_GENERATED_TEXT' | 'USER_PDF', required
  - `content` string

## Response `200`

successful operation

- IntelligentSalesRoomWidget
  - `name` string
  - `id` string, uuid
  - `type` 'ORDER_FORM_PDF' | 'CUSTOMER_INFORMATION' | 'ADDITIONAL_INFORMATION' | 'E_SIGNATURE_BUTTON' | 'ACCEPT_PROPOSAL_BUTTON' | 'MEDIA_CONTENT' | 'RICH_TEXT' | 'AI_GENERATED_TEXT' | 'USER_PDF'
  - `content` string
  - `createdOn` integer
  - `updatedOn` integer
  - `salesRoomId` string
  - `isUserGenerated` boolean
  - `isDeletable` boolean
  - `sortOrder` integer

---

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