API

문서 생성

작성일 2026.03.24 | 수정일 2026.03.25

POST/crm-core/v1/documents

새로운 문서를 생성합니다. MEMBER 이상의 권한이 필요합니다.

chat

문서 발행 방식(issueMethod)은 요청 파라미터에 따라 자동으로 결정됩니다. templateId와 recordId가 모두 있으면 RECORD_TEMPLATE, templateId만 있으면 TEMPLATE_ONLY, 그 외에는 DIRECT_INPUT으로 설정됩니다.

Body Params

Name	Type	Description
documentTypeId	string	문서 유형 ID
entityId	string	개체 ID
recordId	string	연결할 레코드 ID
templateId	string	사용할 템플릿 ID
linkedRecordIds	Array<String>	연결 레코드 ID 목록
issueMethod	string	발행 방식 (DIRECT_INPUT, TEMPLATE_ONLY, RECORD_TEMPLATE)
name	string	문서 이름
content	Object	문서 내용 (TipTap JSON 형식)
variableValues	Object	변수 값 (키-값 쌍)

Response

Name	Type	Required	Description
documentId	string	*	문서 고유 ID
accountId	string	*	계정 고유 ID
documentTypeId	string		문서 유형 ID
entityId	string		개체 ID
recordId	string		레코드 ID
templateId	string		템플릿 ID
linkedRecordIds	Array<String>		연결 레코드 ID 목록
issueMethod	string	*	발행 방식
name	string	*	문서 이름
content	Object		문서 내용
htmlContent	string		HTML 변환 내용
dataSnapshot	Object		생성 시점의 변수 데이터 스냅샷
attachments	Array<Object>		첨부파일 목록
fileId	string	*	파일 고유 ID
fileName	string	*	파일 이름
fileSize	number	*	파일 크기 (바이트)
mimeType	string	*	MIME 타입
url	string	*	파일 URL (서명된 URL)
uploadedAt	date	*	업로드 일시
status	string	*	문서 상태 (DRAFT, FINALIZED, ARCHIVED)
issuedAt	date		발행 일시
ownerId	string		문서 소유자 멤버 ID. 생성 시 현재 멤버 ID로 자동 설정
issuedBy	string		발행자 ID
dateCreated	date	*	최초 생성 날짜
dateUpdated	date	*	최근 수정 날짜

Structure

Request Structure

{
  "documentTypeId": "DTYPE20260324090000ABCDEFGHIJKLM",
  "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
  "recordId": "REC20260324090000ABCDEFGHIJKLMNO",
  "templateId": "DTPL20260324090000ABCDEFGHIJKLM",
  "linkedRecordIds": [
    "샘플값"
  ],
  "name": "샘플",
  "content": {
    "key": "value"
  },
  "variableValues": {
    "key": "value"
  }
}

Response Structure

{
  "documentId": "DOC20260324090000ABCDEFGHIJKLMNO",
  "accountId": "24010100001234",
  "documentTypeId": "DTYPE20260324090000ABCDEFGHIJKLM",
  "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
  "recordId": "REC20260324090000ABCDEFGHIJKLMNO",
  "templateId": "DTPL20260324090000ABCDEFGHIJKLM",
  "linkedRecordIds": [
    "샘플값"
  ],
  "issueMethod": "샘플값",
  "name": "샘플",
  "content": {
    "key": "value"
  },
  "htmlContent": "샘플값",
  "dataSnapshot": {
    "key": "value"
  },
  "attachments": [],
  "ownerId": "MEM20260324090000ABCDEFGHIJKLMNO",
  "status": "ACTIVE",
  "issuedAt": "2026-03-24T09:00:00.000Z",
  "issuedBy": "샘플값",
  "dateCreated": "2026-03-24T09:00:00.000Z",
  "dateUpdated": "2026-03-24T09:00:00.000Z"
}