---
title: "템플릿 생성"
method: POST
path: "/templates"
tags: ["USER API"]
---

# 템플릿 생성

`POST /templates`

## Request body

- CreateTemplateRequestDto
  - `title` string, required — 템플릿 제목
  - `file` Base64DocumentFileInTemplateRequestDto, required
    - `base64` string, required — base64 형식의 문서 파일
    - `extension` 'pdf' | 'hwp' | 'hwpx' | 'doc' | 'docx' | 'xls' | 'xlsx' | 'ppt' | 'pptx' | 'bmp' | 'gif' | 'jpg' | 'jpeg' | 'png' | 'tiff', required — 문서 파일의 확장자
  - `requesterInputs` union[] — 요청자의 입력 (이미지의 개수는 최대 7개)
    - union
      - TextRequesterInputInTemplateRequestDto
        - `dataLabel` string — 데이터 라벨
        - `type` string, required — 요청자 입력 타입 (예시 값으로 고정되어 있습니다)
        - `position` PositionInTemplateRequestDto, required
          - `x` number, required — 입력란의 가로 좌표
          - `y` number, required — 입력란의 세로 좌표
          - `page` integer, required — 입력란이 위치할 페이지
        - `size` TextFieldSizeInTemplateRequestDto, required
          - `width` number, required — 입력란의 너비
          - `height` number, required — 입력란의 높이
        - `textStyle` TextStyleInTemplateRequestDto, required
          - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
          - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
          - `align` 'LEFT' | 'CENTER' | 'RIGHT', required — 텍스트 정렬
        - `value` string, required — 텍스트 박스에 입력될 값
      - CheckboxRequesterInputInTemplateRequestDto
        - `dataLabel` string — 데이터 라벨
        - `type` string, required — 요청자 입력 타입 (예시 값으로 고정되어 있습니다)
        - `position` PositionInTemplateRequestDto, required
          - `x` number, required — 입력란의 가로 좌표
          - `y` number, required — 입력란의 세로 좌표
          - `page` integer, required — 입력란이 위치할 페이지
        - `size` CheckboxFieldSizeInTemplateRequestDto, required
          - `width` number, required — 입력란의 너비
        - `value` boolean, required — 체크박스의 체크 여부
      - ImageRequesterInputInTemplateRequestDto
        - `dataLabel` string — 데이터 라벨
        - `type` string, required — 요청자 입력 타입 (예시 값으로 고정되어 있습니다)
        - `position` PositionInTemplateRequestDto, required
          - `x` number, required — 입력란의 가로 좌표
          - `y` number, required — 입력란의 세로 좌표
          - `page` integer, required — 입력란이 위치할 페이지
        - `size` ImageFieldSizeInTemplateRequestDto, required
          - `width` number, required — 입력란의 너비
          - `height` number, required — 입력란의 높이
        - `value` ImageInfoInTemplateRequestDto
          - `base64` string, required — 이미지 데이터를 base64로 인코딩한 문자열
      - DropdownRequesterInputInTemplateRequestDto
        - `dataLabel` string — 데이터 라벨
        - `type` string, required — 요청자 입력 타입 (예시 값으로 고정되어 있습니다)
        - `position` PositionInTemplateRequestDto, required
          - `x` number, required — 입력란의 가로 좌표
          - `y` number, required — 입력란의 세로 좌표
          - `page` integer, required — 입력란이 위치할 페이지
        - `size` DropdownFieldSizeInTemplateRequestDto, required
          - `width` number, required — 입력란의 너비
          - `height` number, required — 입력란의 높이
        - `options` DropdownOption[], required — 드롭다운 옵션 목록
          - `value` string, required — 드롭다운 옵션 값
        - `defaultInputValue` string, required — 드롭다운 옵션의 기본 입력 값
        - `textStyle` TextStyleInTemplateRequestDto, required
          - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
          - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
          - `align` 'LEFT' | 'CENTER' | 'RIGHT', required — 텍스트 정렬
      - NameRequesterInputInTemplateRequestDto
        - `dataLabel` string — 데이터 라벨
        - `type` string, required — 요청자 입력 타입 (예시 값으로 고정되어 있습니다)
        - `position` PositionInTemplateRequestDto, required
          - `x` number, required — 입력란의 가로 좌표
          - `y` number, required — 입력란의 세로 좌표
          - `page` integer, required — 입력란이 위치할 페이지
        - `size` NameFieldSizeInTemplateRequestDto, required
          - `width` number, required — 입력란의 너비
          - `height` number, required — 입력란의 높이
        - `textStyle` TextStyleInTemplateRequestDto, required
          - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
          - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
          - `align` 'LEFT' | 'CENTER' | 'RIGHT', required — 텍스트 정렬
  - `requesterAttachments` RequesterAttachmentInCreateTemplateRequestDto[] — 요청자 첨부파일 정보. 서명자 첨부파일과 합산하여 최대 30개까지 첨부 가능
    - `name` string, required — 첨부파일 이름 (특수문자 /?<>\":*|₩ 이 포함된 이름은 사용할 수 없습니다)
    - `file` FileInfoInCreateTemplateRequestDto, required
      - `fileId` string, required — 파일 업로드 API 를 통해 얻은 파일 ID
      - `token` string, required — 파일 업로드 API 를 통해 얻은 파일 토큰
      - `name` string, required — 첨부파일명 (확장자 제외, 특수문자 /?<>\":*|₩ 이 포함된 이름은 사용할 수 없습니다)
  - `participants` ParticipantInTemplateRequestDto[], required — 문서의 참여자 정보
    - `type` 'SIGNER' | 'VIEWER' — 참여자 타입
    - `role` string, required — 참여자의 역할
    - `name` string — 참여자 이름 (특수문자 /?<>\":*|₩ 이 포함된 이름은 사용할 수 없습니다)
    - `signingOrder` integer, required — 참여 순서. 순서 없이 참여하려면 모두 1로 설정하세요.
    - `signingMethod` SigningMethodInTemplateRequestDto
      - `type` '' | 'KAKAO' | 'EMAIL' | 'SECURE_LINK', required — 참여 수단 종류
      - `value` string, required — 참여자의 참여 수단 (이메일 또는 휴대전화번호)
    - `attachmentRequests` AttachmentRequestInTemplateRequestDto[] — 첨부파일 요청 정보
      - `dataLabel` string — 데이터 라벨
      - `name` string, required — 첨부파일 이름 (특수문자 /?<>\":*|₩ 이 포함된 이름은 사용할 수 없습니다)
      - `message` string, nullable — 첨부파일에 대한 설명
      - `required` boolean, required — 필수 여부
    - `fields` union[] — 문서 필드 정보 - VIEWER 타입 참여자는 필드를 가질 수 없습니다 - 참여자의 필드 개수 총합은 최대 2000개까지 지원합니다
      - union
        - CheckboxFieldInTemplateRequestDto
          - `dataLabel` string — 데이터 라벨. 그룹 라벨과 함께 사용할 수 없습니다.
          - `type` string, required — 필드 타입 (CHECKBOX로 요청해야 합니다)
          - `required` boolean — 필수 여부 (체크박스가 그룹에 속하는 경우 무시됩니다.)
          - `size` CheckboxFieldSizeInTemplateRequestDto, required
            - `width` number, required — 입력란의 너비
          - `position` PositionInTemplateRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
          - `groupLabel` string, nullable — 그룹 라벨
          - `valueDescription` string — 체크박스 내용, 체크박스를 호버하거나 한번에 선택할때 서명자에게 노출됩니다.
          - `enableOneClick` boolean — 체크박스를 한번에 선택(체크) 할 수 있는 여부, 문서 서명시 활성화된 체크박스는 서명자가 확인 후 한번에 체크할 수 있습니다.
          - `prefilledValue` boolean, nullable — 사전 입력값
        - SignatureFieldInTemplateRequestDto
          - `dataLabel` string — 데이터 라벨
          - `type` string, required — 필드 타입 (SIGNATURE로 요청해야 합니다)
          - `required` boolean — 필수 여부 (type이 `SIGNATURE`일 경우는 무조건 true가 됩니다)
          - `signatureTypes` string[] — 서명 타입
          - `allowedGenerationMethods` string[] — 서명 생성 방식
          - `position` PositionInTemplateRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
          - `size` SignatureFieldSizeInTemplateRequestDto
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `enableOneClick` boolean — 한번에 서명 활성화 여부
        - TextFieldInTemplateRequestDto
          - `dataLabel` string — 데이터 라벨
          - `type` string, required — 필드 타입 (TEXT로 요청해야 합니다)
          - `required` boolean — 필수 여부
          - `size` TextFieldSizeInTemplateRequestDto, required
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` PositionInTemplateRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
          - `textStyle` TextStyleInTemplateRequestDto, required
            - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
            - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
            - `align` 'LEFT' | 'CENTER' | 'RIGHT', required — 텍스트 정렬
          - `format` union — 입력 형식 (정규 표현식 등)
            - PhoneNumberFormatInTemplateRequestDto
              - …
            - BankAccountNumberFormatInTemplateRequestDto
              - …
            - BizNumberFormatInTemplateRequestDto
              - …
            - RegexFormatInTemplateRequestDto
              - …
          - `prefilledValue` string, nullable — 사전 입력값
        - SigningDateInTemplateRequestDto
          - `dataLabel` string — 데이터 라벨
          - `type` string, required — 필드 타입 (SIGNING_DATE로 요청해야 합니다)
          - `size` SigningDateFieldSizeInTemplateRequestDto, required
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` PositionInTemplateRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
          - `textStyle` TextStyleInTemplateRequestDto, required
            - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
            - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
            - `align` 'LEFT' | 'CENTER' | 'RIGHT', required — 텍스트 정렬
          - `displayFormat` 'YYYY-MM-DD' | 'YYYY/DD/MM' | 'YYYY.MM.DD' | 'YYYYMMDD' | 'YYYY년 MM월 DD일' | 'DD-MM-YYYY' | 'DD/MM/YYYY' | 'DD.MM.YYYY' | 'DDMMYYYY' | 'DD일 MM월 YYYY년' | 'MM-DD-YYYY' | 'MM/DD/YYYY' | 'MM.DD.YYYY' | 'MMDDYYYY' | 'MM월 DD일 YYYY년' | 'YYYY/MM/DD' | 'YYYY-DD-MM' | 'YYYY.DD.MM' | 'YYYYDDMM' | 'YYYY년 DD일 MM월' | 'YY-MM-DD' | 'YY/MM/DD' | 'YY.MM.DD' | 'YYMMDD' | 'YY년 MM월 DD일' | 'DD-MM-YY' | 'DD/MM/YY' | 'DD.MM.YY' | 'DDMMYY' | 'DD일 MM월 YY년' | 'MM-DD-YY' | 'MM/DD/YY' | 'MM.DD.YY' | 'MMDDYY' | 'MM월 DD일 YY년' | 'YY-DD-MM' | 'YY/DD/MM' | 'YY.DD.MM' | 'YYDDMM' | 'YY년 DD일 MM월', required — 날짜 표기 형식
        - DateFieldInTemplateRequestDto
          - `dataLabel` string — 데이터 라벨
          - `type` string, required — 필드 타입 (DATE로 요청해야 합니다)
          - `required` boolean — 필수 여부
          - `size` DateFieldSizeInTemplateRequestDto, required
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` PositionInTemplateRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
          - `textStyle` TextStyleInTemplateRequestDto, required
            - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
            - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
            - `align` 'LEFT' | 'CENTER' | 'RIGHT', required — 텍스트 정렬
          - `displayFormat` 'YYYY-MM-DD' | 'YYYY/DD/MM' | 'YYYY.MM.DD' | 'YYYYMMDD' | 'YYYY년 MM월 DD일' | 'DD-MM-YYYY' | 'DD/MM/YYYY' | 'DD.MM.YYYY' | 'DDMMYYYY' | 'DD일 MM월 YYYY년' | 'MM-DD-YYYY' | 'MM/DD/YYYY' | 'MM.DD.YYYY' | 'MMDDYYYY' | 'MM월 DD일 YYYY년' | 'YYYY/MM/DD' | 'YYYY-DD-MM' | 'YYYY.DD.MM' | 'YYYYDDMM' | 'YYYY년 DD일 MM월' | 'YY-MM-DD' | 'YY/MM/DD' | 'YY.MM.DD' | 'YYMMDD' | 'YY년 MM월 DD일' | 'DD-MM-YY' | 'DD/MM/YY' | 'DD.MM.YY' | 'DDMMYY' | 'DD일 MM월 YY년' | 'MM-DD-YY' | 'MM/DD/YY' | 'MM.DD.YY' | 'MMDDYY' | 'MM월 DD일 YY년' | 'YY-DD-MM' | 'YY/DD/MM' | 'YY.DD.MM' | 'YYDDMM' | 'YY년 DD일 MM월', required — 날짜 표기 형식
          - `prefilledValue` string, nullable — 사전 입력값
        - DropdownFieldInTemplateRequestDto
          - `dataLabel` string — 데이터 라벨
          - `type` string, required — 필드 타입 (DROPDOWN으로 요청해야 합니다)
          - `required` boolean — 필수 여부
          - `size` DropdownFieldSizeInTemplateRequestDto, required
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` PositionInTemplateRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
          - `options` DropdownOption[], required — 드롭다운 옵션 목록
            - `value` string, required — 드롭다운 옵션 값
          - `defaultInputValue` string, nullable — 기본값
          - `textStyle` TextStyleInTemplateRequestDto, required
            - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
            - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
            - `align` 'LEFT' | 'CENTER' | 'RIGHT', required — 텍스트 정렬
          - `prefilledValue` string, nullable — 사전 입력값
        - NameFieldInTemplateRequestDto
          - `dataLabel` string — 데이터 라벨. 그룹 라벨과 함께 사용할 수 없습니다.
          - `type` string, required — 필드 타입 (NAME으로 요청해야 합니다)
          - `required` boolean — 필수 여부
          - `size` NameFieldSizeInTemplateRequestDto, required
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` PositionInTemplateRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
          - `textStyle` TextStyleInTemplateRequestDto, required
            - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
            - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
            - `align` 'LEFT' | 'CENTER' | 'RIGHT', required — 텍스트 정렬
        - CompanyNameFieldInTemplateRequestDto
          - `dataLabel` string — 데이터 라벨. 그룹 라벨과 함께 사용할 수 없습니다.
          - `type` string, required — 필드 타입 (COMPANY_NAME으로 요청해야 합니다)
          - `required` boolean — 필수 여부
          - `size` NameFieldSizeInTemplateRequestDto, required
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` PositionInTemplateRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
          - `textStyle` TextStyleInTemplateRequestDto, required
            - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
            - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
            - `align` 'LEFT' | 'CENTER' | 'RIGHT', required — 텍스트 정렬
          - `prefilledValue` string, nullable — 사전 입력값
        - AddressFieldInTemplateRequestDto
          - `dataLabel` string — 데이터 라벨. 그룹 라벨과 함께 사용할 수 없습니다.
          - `type` string, required — 필드 타입 (ADDRESS로 요청해야 합니다)
          - `required` boolean — 필수 여부
          - `size` TextFieldSizeInTemplateRequestDto, required
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` PositionInTemplateRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
          - `textStyle` TextStyleInTemplateRequestDto, required
            - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
            - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
            - `align` 'LEFT' | 'CENTER' | 'RIGHT', required — 텍스트 정렬
          - `prefilledValue` AddressPrefilledValueInTemplateRequestDto
            - `address1` string, required — 기본 주소
            - `address2` string, nullable — 상세 주소
            - `city` string, nullable — 시군구
            - `province` string, required — 도시
            - `zip` string, required — 우편번호
            - `country` 'KR', required — 나라
        - ImageFieldInTemplateRequestDto
          - `dataLabel` string — 데이터 라벨
          - `type` string, required — 필드 타입 (IMAGE로 요청해야 합니다)
          - `required` boolean — 필수 여부
          - `size` ImageFieldSizeInTemplateRequestDto, required
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` PositionInTemplateRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
    - `checkboxFieldGroups` CheckboxGroupInTemplateRequestDto[] — 체크박스 그룹
      - `groupLabel` string, required — 그룹 라벨
      - `minCheckRequired` 0 | 1, required — 최소 선택 개수. 현재는 0 또는 1만 지원합니다.
      - `maxCheckLimit` integer, nullable — 최대 선택 개수. 현재는 1또는 null만 지원합니다. null은 최대 개수까지 선택가능함을 뜻합니다.
    - `verification` VerificationInCreateTemplateRequestDto
      - `password` PasswordInCreateTemplateRequestDto, required
        - `enabled` boolean, required — 추가 인증 사용 여부
      - `mobileIdentification` MobileIdentificationInCreateTemplateRequestDto, required
        - `enabled` boolean, required — 추가 인증 사용 여부
        - `allowOptions` string[] — 휴대폰 본인 인증 옵션
      - `dCert` DCertInCreateTemplateRequestDto, required
        - `enabled` boolean, required — 추가 인증 사용 여부
  - `documentLabelIds` string[], nullable — 문서 생성시 기본 설정될 라벨 ID 목록
  - `metadatas` MetadataInTemplateRequestDto[], nullable — 메타데이터 리스트. 최대 10개까지 등록 가능 (응답의 메타데이터는 순서가 보장되지 않습니다)
    - `key` string, required — 메타데이터 키
    - `value` string — 메타데이터 값
  - `requesterEditable` boolean, nullable, required — 템플릿으로 서명 요청 시 문서의 내용이 변경 가능한 여부 (false 인 경우 기본적인 발송 설정을 제외한, 서명자 필드와 같은 데이터를 수정하여 발송할 수 없습니다)
  - `carbonCopies` CarbonCopyInTemplateRequestDto[] — 참조자 정보
    - `contact` string, required — 참조자 연락처 (이메일 주소 또는 휴대전화번호)
    - `locale` 'ko' | 'en' | 'zh-CN' | 'ja' | 'vi', required — 참조자 언어
  - `seal` DocumentSealInTemplateRequestDto
    - `integritySeal` IntegritySealInTemplateRequestDto, required
      - `enabled` boolean, required — 진본 증명 도장 활성화 여부
      - `position` 'TOP_LEFT' | 'TOP_RIGHT' | 'BOTTOM_LEFT' | 'BOTTOM_RIGHT', required — 진본 증명 도장 위치

## Response `201`

- CreateTemplateResponseDto
  - `id` string, required — 템플릿의 ID
  - `metadatas` MetadataInTemplateResponseDto[], required — 메타데이터 리스트
    - `key` string, required — 메타데이터 키
    - `value` string, required — 메타데이터 값
  - `title` string, required — 템플릿 제목
  - `createdAt` string, date-time, required — 템플릿 생성 시간
  - `updatedAt` string, date-time, required — 템플릿 마지막 업데이트 시간
  - `file` TemplateFileInTemplateResponseDto
    - `downloadUrl` string, required — 다운로드 링크(유효시간: 10분)
  - `requesterInputs` union[], required — 템플릿에 적용된 추가내용 입력
    - union
      - TextRequesterInputInTemplateResponseDto
        - `dataLabel` string, required — 데이터 라벨
        - `type` string, required — 요청자 입력 타입 (예시 값으로 고정되어 있습니다)
        - `position` PositionInTemplateResponseDto, required
          - `x` number, required — 입력란의 가로 좌표
          - `y` number, required — 입력란의 세로 좌표
          - `page` integer, required — 입력란이 위치할 페이지
        - `size` SizeInTemplateResponseDto, required
          - `width` number, required — 입력란의 너비
          - `height` number, required — 입력란의 높이
        - `textStyle` TextStyleInTemplateResponseDto, required
          - `size` integer, required — 텍스트 크기
          - `font` string, required — 텍스트 글자체
          - `align` string, required — 텍스트 정렬
        - `value` string, required — 텍스트 박스에 들어갈 내용
      - CheckboxRequesterInputInTemplateResponseDto
        - `dataLabel` string, required — 추가내용 입력의 데이터 라벨
        - `type` string, required — 요청자 입력 타입 (예시 값으로 고정되어 있습니다)
        - `position` PositionInTemplateResponseDto, required
          - `x` number, required — 입력란의 가로 좌표
          - `y` number, required — 입력란의 세로 좌표
          - `page` integer, required — 입력란이 위치할 페이지
        - `size` SizeInTemplateResponseDto, required
          - `width` number, required — 입력란의 너비
          - `height` number, required — 입력란의 높이
        - `value` boolean, required — 체크 박스의 체크 여부
      - ImageRequesterInputInTemplateResponseDto
        - `dataLabel` string, required — 데이터 라벨
        - `type` string, required — 추가내용 입력 타입 (예시 값으로 고정되어 있습니다)
        - `position` PositionInTemplateResponseDto, required
          - `x` number, required — 입력란의 가로 좌표
          - `y` number, required — 입력란의 세로 좌표
          - `page` integer, required — 입력란이 위치할 페이지
        - `size` SizeInTemplateResponseDto
          - `width` number, required — 입력란의 너비
          - `height` number, required — 입력란의 높이
        - `value` ImageInfoInTemplateResponseDto
          - `downloadUrl` string, required — 이미지 다운로드 링크 (10분간 유효)
      - DropdownRequesterInputInTemplateResponseDto
        - `dataLabel` string, required — 데이터 라벨
        - `type` string, required — 추가내용 입력 타입 (예시 값으로 고정되어 있습니다)
        - `position` PositionInTemplateResponseDto, required
          - `x` number, required — 입력란의 가로 좌표
          - `y` number, required — 입력란의 세로 좌표
          - `page` integer, required — 입력란이 위치할 페이지
        - `size` SizeInTemplateResponseDto
          - `width` number, required — 입력란의 너비
          - `height` number, required — 입력란의 높이
        - `textStyle` TextStyleInTemplateResponseDto, required
          - `size` integer, required — 텍스트 크기
          - `font` string, required — 텍스트 글자체
          - `align` string, required — 텍스트 정렬
        - `options` DropdownOption[], required — 드롭다운 옵션
          - `value` string, required — 드롭다운 옵션 값
        - `value` string, required — 드롭다운 필드에 들어갈 내용
      - NameRequesterInputInTemplateResponseDto
        - `dataLabel` string, required — 데이터 라벨
        - `type` string, required — 추가내용 입력 타입 (예시 값으로 고정되어 있습니다)
        - `position` PositionInTemplateResponseDto, required
          - `x` number, required — 입력란의 가로 좌표
          - `y` number, required — 입력란의 세로 좌표
          - `page` integer, required — 입력란이 위치할 페이지
        - `size` SizeInTemplateResponseDto
          - `width` number, required — 입력란의 너비
          - `height` number, required — 입력란의 높이
        - `textStyle` TextStyleInTemplateResponseDto, required
          - `size` integer, required — 텍스트 크기
          - `font` string, required — 텍스트 글자체
          - `align` string, required — 텍스트 정렬
        - `value` string, required — 이름 필드에 들어갈 내용
  - `requesterAttachments` RequesterAttachmentInTemplateResponseDto[], required — 설정된 요청자 첨부파일 정보
    - `dataLabel` string, required — 요청자 첨부파일의 데이터 라벨
    - `name` string, required — 첨부파일 종류
    - `file` RequesterAttachmentFileInTemplateResponseDto, required
      - `name` string, required — 파일명
      - `extension` string, required — 파일 확장자
      - `size` number, required — 파일 크기 (Byte)
      - `downloadUrl` string, required — 다운로드 링크(유효시간: 10분)
  - `participants` union[], required — 설정된 참여자 정보
    - union
      - SignerInParticipantTemplateResponseDto
        - `type` 'SIGNER', required — 참여자 타입
        - `role` string, required — 참여자의 역할
        - `signingOrder` integer, required — 참여자의 서명/열람 순서
        - `name` string — 참여자의 이름 (공란일 수 있음)
        - `signingMethod` SigningMethodInTemplateResponseDto
          - `type` 'EMAIL' | 'KAKAO' | 'SECURE_LINK' | 'IN_PERSON', required — 참여 수단 종류
          - `value` string, required — 참여자의 참여 수단 (이메일 또는 휴대전화번호)
        - `attachmentRequests` AttachmentRequestInTemplateResponseDto[], required — 첨부파일 요청 정보
          - `name` string, required — 첨부파일 종류
          - `message` string, nullable — 추가 안내 사항
          - `required` boolean, required — 필수 여부
          - `dataLabel` string, required — 첨부파일의 데이터 라벨
        - `fields` union[], required — 참여자 입력란
          - union
            - SignatureFieldInTemplateResponseDto
              - …
            - TextFieldInTemplateResponseDto
              - …
            - CheckboxFieldInTemplateResponseDto
              - …
            - DropdownFieldInTemplateResponseDto
              - …
            - NameFieldInTemplateResponseDto
              - …
            - CompanyNameFieldInTemplateResponseDto
              - …
            - AddressFieldInTemplateResponseDto
              - …
            - DateFieldInTemplateResponseDto
              - …
            - SigningDateFieldInTemplateResponseDto
              - …
            - ImageFieldInTemplateResponseDto
              - …
        - `fieldGroups` union[], required — 참여자 입력란 그룹
          - union
            - CheckboxFieldGroupInTemplateResponseDto
              - …
            - AutofillFieldGroupInTemplateResponseDto
              - …
        - `checkboxFieldGroups` DeprecatedCheckboxFieldGroupInTemplateResponseDto[], required — 체크박스 그룹 (deprecated 되었으며 fieldGroups를 대신 활용해주세요)
          - `groupLabel` string, required — 체크박스 그룹 라벨
          - `minCheckRequired` number, required — 최소 선택 개수. 현재는 0 또는 1만 지원합니다.
          - `maxCheckLimit` number, nullable, required — 최대 선택 개수. 현재는 1또는 null만 지원합니다. null은 최대 개수까지 선택가능함을 뜻합니다.
        - `verification` VerificationInTemplateResponseDto, required
          - `password` ParticipantPasswordInTemplateResponseDto
            - `enabled` boolean, required — 추가 인증 사용 여부
          - `mobileIdentification` ParticipantMobileIdentificationInTemplateResponseDto
            - `enabled` boolean, required — 추가 인증 사용 여부
          - `dCert` ParticipantDCertInTemplateResponseDto
            - `enabled` boolean, required — 추가 인증 사용 여부
      - ViewerInParticipantTemplateResponseDto
        - `type` 'VIEWER', required — 참여자 타입
        - `role` string, required — 참여자의 역할
        - `signingOrder` integer, required — 참여자의 서명/열람 순서
        - `name` string — 참여자의 이름 (공란일 수 있음)
        - `signingMethod` SigningMethodInTemplateResponseDto
          - `type` 'EMAIL' | 'KAKAO' | 'SECURE_LINK' | 'IN_PERSON', required — 참여 수단 종류
          - `value` string, required — 참여자의 참여 수단 (이메일 또는 휴대전화번호)
        - `attachmentRequests` AttachmentRequestInTemplateResponseDto[], required — 첨부파일 요청 정보
          - `name` string, required — 첨부파일 종류
          - `message` string, nullable — 추가 안내 사항
          - `required` boolean, required — 필수 여부
          - `dataLabel` string, required — 첨부파일의 데이터 라벨
        - `fields` union[], required — 참여자 입력란
          - union
            - SignatureFieldInTemplateResponseDto
              - …
            - TextFieldInTemplateResponseDto
              - …
            - CheckboxFieldInTemplateResponseDto
              - …
            - DropdownFieldInTemplateResponseDto
              - …
            - NameFieldInTemplateResponseDto
              - …
            - CompanyNameFieldInTemplateResponseDto
              - …
            - AddressFieldInTemplateResponseDto
              - …
            - DateFieldInTemplateResponseDto
              - …
            - SigningDateFieldInTemplateResponseDto
              - …
            - ImageFieldInTemplateResponseDto
              - …
        - `fieldGroups` union[], required — 참여자 입력란 그룹
          - union
            - CheckboxFieldGroupInTemplateResponseDto
              - …
            - AutofillFieldGroupInTemplateResponseDto
              - …
        - `checkboxFieldGroups` DeprecatedCheckboxFieldGroupInTemplateResponseDto[], required — 체크박스 그룹 (deprecated 되었으며 fieldGroups를 대신 활용해주세요)
          - `groupLabel` string, required — 체크박스 그룹 라벨
          - `minCheckRequired` number, required — 최소 선택 개수. 현재는 0 또는 1만 지원합니다.
          - `maxCheckLimit` number, nullable, required — 최대 선택 개수. 현재는 1또는 null만 지원합니다. null은 최대 개수까지 선택가능함을 뜻합니다.
        - `verification` VerificationInTemplateResponseDto, required
          - `password` ParticipantPasswordInTemplateResponseDto
            - `enabled` boolean, required — 추가 인증 사용 여부
          - `mobileIdentification` ParticipantMobileIdentificationInTemplateResponseDto
            - `enabled` boolean, required — 추가 인증 사용 여부
          - `dCert` ParticipantDCertInTemplateResponseDto
            - `enabled` boolean, required — 추가 인증 사용 여부
        - `manuallyViewing` boolean, required — 상세 열람 여부
  - `documentLabels` DocumentLabelInTemplateResponseDto[], required — 해당 템플릿으로 참여 요청 시 자동으로 적용될 라벨 목록
    - `id` string, required — 라벨 ID
    - `name` string, required — 라벨 이름
    - `description` string, nullable, required — 라벨의 설명
  - `requesterEditable` boolean, required — 템플릿으로 서명 요청 시 문서의 내용이 변경 가능한 여부 (false 인 경우 기본적인 발송 설정을 제외한, 서명자 필드와 같은 데이터를 수정하여 발송할 수 없습니다)
  - `carbonCopies` CarbonCopyInTemplateResponseDto[], required — 참조자 정보
    - `contact` string, required — 참조자 연락처
    - `locale` 'ko' | 'en' | 'zh-CN' | 'ja' | 'vi', required — 참조자 언어
  - `seal` DocumentSealInTemplateResponseDto, required
    - `integritySeal` IntegritySealInTemplateResponseDto, required
      - `enabled` boolean, required — 진본 증명 도장 활성화 여부
      - `position` 'TOP_LEFT' | 'TOP_RIGHT' | 'BOTTOM_LEFT' | 'BOTTOM_RIGHT', required — 진본 증명 도장 위치

---

[API](https://skmtc.net/modusign/apis/modusign-api.md) · [All operations](https://skmtc.net/modusign/apis/modusign-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modusign/modusign-api/versions/5772e872cbf9/schema)