---
title: "템플릿으로 임베디드 초안 생성"
method: POST
path: "/embedded-drafts/create-with-template"
tags: ["USER API"]
---

# 템플릿으로 임베디드 초안 생성

`POST /embedded-drafts/create-with-template`

## Request body

- CreateEmbeddedDraftWithTemplateRequestDto
  - `redirectUrl` string — 임베딩된 서명요청 화면에서 서명요청 완료 후 이동할 주소
  - `templateId` string, required — 모두싸인에 미리 만들어 둔 템플릿의 ID
  - `document` DocumentInDraftWithTemplateRequestDto
    - `title` string — 문서의 제목
    - `fileOpenPassword` string — 완료문서(.pdf) 비밀번호
    - `participantMappings` ParticipantMappingInDraftWithTemplateRequestDto[] — 템플릿에 동적으로 적용할 참여자 정보
      - `role` string, required — 템플릿에 적용해둔 참여자의 역할
      - `name` string — 참여자 이름
      - `signingDuration` number — 참여자의 참여 유효 기간 (분) * 미지정시 기본값 20160분 (14일)
      - `requesterMessage` string, nullable — 참여자에게 전달할 남길말
      - `excluded` boolean — 템플릿에 적용해 둔 참여자를 제외시킬지 여부
      - `signingMethod` SigningMethodInDraftWithTemplateRequestDto
        - `type` 'KAKAO' | 'EMAIL' | 'SECURE_LINK', required — 참여 수단 종류
        - `value` string, required — 참여자의 참여 수단 (이메일 또는 휴대전화번호)
      - `attachmentRequests` TemplateAttachmentRequestInDraftWithTemplateRequestDto[] — 첨부파일 요청 정보
        - `dataLabel` string, required — 추가 첨부파일의 데이터 레이블 (기존 customId는 deprecated)
        - `excluded` boolean — 문서에 해당 첨부파일 요청을 제외할지 여부
        - `required` boolean — 필수 여부
      - `verification` VerificationInDraftWithTemplateRequestDto
        - `password` PasswordInDraftWithTemplateRequestDto
          - `value` string, required — 비밀번호
          - `hint` string — 비밀번호 힌트
        - `mobileIdentification` MobileIdentificationInDraftWithTemplateRequestDto
          - `name` string — 휴대폰 본인 인증의 명의자 이름
          - `phoneNumber` string — 휴대폰 본인 인증의 명의자 전화번호
          - `allowOptions` string[] — 휴대폰 본인 인증 옵션
        - `dCert` DCertInDraftWithTemplateRequestDto
          - `name` string — 법인 공동인증서 인증 법인명
          - `bizNumber` string — 법인 공동인증서 인증 사업자 등록번호
      - `fieldMappings` ParticipantFieldMappingInDraftWithTemplateRequestDto[] — 필드 매핑 정보, 서명자인 경우에만 적용됩니다.
        - `dataLabel` string, required — 데이터 라벨, 그룹 라벨을 지정한 경우 그룹 단위로 지정됩니다.
        - `excluded` boolean, required — 필드 제외 여부, 제외 할 경우 서명자 필드로 적용되지 않습니다.
        - `prefilledValue` object, nullable — 사전 입력값. 템플릿에 설정된 기본 프리필 값을 오버라이드합니다. TEXT, COMPANY_NAME: string, CHECKBOX: boolean, DATE: ISO 8601 string, DROPDOWN: 옵션 값 string, ADDRESS: { address1, address2, city, province, zip, country } 객체
    - `requesterInputMappings` RequesterInputMappingInDraftWithTemplateRequestDto[] — 추가 내용 입력
      - `dataLabel` string, required — 데이터 라벨 (기존 customId는 deprecated)
      - `value` union, required — 요청자 입력 매핑 값
        - string — 텍스트 필드인 경우, 필드에 들어갈 문자열
        - boolean — 체크박스 필드인 경우, 체크박스의 체크 여부
        - ImageInfoInDraftWithTemplateRequestDto
          - `base64` string, required — 3MB 이하의 jpg 또는 png 이미지 데이터를 base64로 인코딩한 문자열
    - `carbonCopies` CarbonCopy[] — 문서의 참조자들 정보
      - `contact` string, required — 참조자 연락처 (이메일 주소 또는 휴대전화번호)
      - `locale` 'ko' | 'en' | 'zh-CN' | 'ja' | 'vi' — 참조자 언어
    - `auditTrail` AuditTrailRequestDto
      - `locales` string[], required — 감사 추적 인증서 제공 언어
    - `metadatas` MetadataInDraftWithTemplateRequestDto[] — 메타데이터 리스트. 최대 10개까지 등록 가능 (응답의 메타데이터는 순서가 보장되지 않습니다)
      - `key` string, required — 메타데이터 키
      - `value` string — 메타데이터 값
    - `seal` DocumentSealInDraftWithTemplateRequestDto
      - `integritySeal` IntegritySealInDraftWithTemplateRequestDto, required
        - `enabled` boolean, required — 진본 증명 도장 활성화 여부
        - `position` 'TOP_LEFT' | 'TOP_RIGHT' | 'BOTTOM_LEFT' | 'BOTTOM_RIGHT', required — 진본 증명 도장 위치
  - `brandId` string — 브랜드 ID

## Response `201`

드래프트 정보

- CreateEmbeddedDraftWithTemplateResponseDto
  - `id` string, required — 생성된 초안의 ID
  - `embeddedUrl` string, required — 임베딩 가능한 서명 요청 주소(유효시간: 2시간)
  - `expiry` string, date-time, required — 생성된 초안의 만료 시간
  - `brandId` string — 브랜드 ID

---

[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)