API

문서 템플릿 생성

작성일 2026.03.24 | 수정일 2026.03.25

POST/crm-core/v1/document-templates

새로운 문서 템플릿을 생성합니다. OWNER 권한이 필요합니다.

Body Params

Name	Type	Required	Description
documentTypeId	string		문서 유형 ID
name	string	*	템플릿 이름
description	string		템플릿 설명
content	Object		템플릿 내용 (TipTap JSON 형식)
variables	Array<Object>		템플릿 변수 목록
key	string	*	변수 키
label	string	*	변수 라벨
type	string	*	변수 유형 (SYSTEM, PROPERTY, LINKED_TABLE)
sourceEntityId	string		소스 개체 ID (PROPERTY 유형에서 사용)
linkedTableConfigs	Array<Object>		연결 테이블 설정 목록
key	string	*	테이블 키
sourceEntityId	string	*	소스 개체 ID
relationshipTypeId	string	*	관계 유형 ID
targetEntityId	string	*	대상 개체 ID
columnPropertyIds	Array<String>	*	컬럼 속성 ID 목록

Response

Name	Type	Required	Description
templateId	string	*	템플릿 고유 ID
accountId	string	*	계정 고유 ID
documentTypeId	string		문서 유형 ID
name	string	*	템플릿 이름
description	string		템플릿 설명
content	Object		템플릿 내용
variables	Array<Object>		템플릿 변수 목록
key	string	*	변수 키
label	string	*	변수 라벨
type	string	*	변수 유형
sourceEntityId	string		소스 개체 ID
linkedTableConfigs	Array<Object>		연결 테이블 설정
key	string	*	테이블 키
sourceEntityId	string	*	소스 개체 ID
relationshipTypeId	string	*	관계 유형 ID
targetEntityId	string	*	대상 개체 ID
columnPropertyIds	Array<String>	*	컬럼 속성 ID 목록
dateCreated	date	*	최초 생성 날짜
dateUpdated	date	*	최근 수정 날짜

Structure

Request Structure

{
  "documentTypeId": "DTYPE20260324090000ABCDEFGHIJKLM",
  "name": "샘플",
  "description": "설명 텍스트",
  "content": {
    "key": "value"
  },
  "variables": [
    {
      "key": "tk_live_xxxxxxxxxxxxxxxx",
      "label": "라벨",
      "type": "TYPE_SAMPLE",
      "sourceEntityId": "ID_SAMPLE_12345"
    }
  ],
  "linkedTableConfigs": [
    {
      "key": "tk_live_xxxxxxxxxxxxxxxx",
      "sourceEntityId": "ID_SAMPLE_12345",
      "relationshipTypeId": "ID_SAMPLE_12345",
      "targetEntityId": "ID_SAMPLE_12345",
      "columnPropertyIds": [
        "샘플값"
      ]
    }
  ]
}

Response Structure

{
  "templateId": "DTPL20260324090000ABCDEFGHIJKLM",
  "accountId": "24010100001234",
  "documentTypeId": "DTYPE20260324090000ABCDEFGHIJKLM",
  "name": "샘플",
  "description": "설명 텍스트",
  "content": {
    "key": "value"
  },
  "variables": [
    {
      "key": "tk_live_xxxxxxxxxxxxxxxx",
      "label": "라벨",
      "type": "TYPE_SAMPLE",
      "sourceEntityId": "ID_SAMPLE_12345"
    }
  ],
  "linkedTableConfigs": [
    {
      "key": "tk_live_xxxxxxxxxxxxxxxx",
      "sourceEntityId": "ID_SAMPLE_12345",
      "relationshipTypeId": "ID_SAMPLE_12345",
      "targetEntityId": "ID_SAMPLE_12345",
      "columnPropertyIds": [
        "샘플값"
      ]
    }
  ],
  "dateCreated": "2026-03-24T09:00:00.000Z",
  "dateUpdated": "2026-03-24T09:00:00.000Z"
}