{"openapi":"3.1.0","info":{"title":"EZSender API","version":"1.2.0","description":"EZSender 단건 알림, 이메일 캠페인, 주소록, 수신자, 자동화 REST API"},"servers":[{"url":"https://ezsender.net/api/v1"}],"components":{"schemas":{"Error":{"type":"object","properties":{"code":{"type":"string"},"httpStatusCode":{"type":"integer"},"message":{"type":"string"},"details":{}},"required":["code","httpStatusCode","message"]},"Pagination":{"type":"object","properties":{"page":{"type":"integer","minimum":1,"maximum":2147483647},"limit":{"type":"integer","minimum":1,"maximum":2147483647},"total":{"type":"integer","minimum":0},"totalPages":{"type":"integer","minimum":0}},"required":["page","limit","total","totalPages"]},"Campaign":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"title":{"type":"string","description":"생략하면 subject 사용"},"subject":{"type":"string","minLength":1,"description":"이메일 제목. {{이름}}·{{이메일}}과 등록한 필드(정보항목) 코드를 사용할 수 있습니다."},"html":{"type":"string","description":"이메일 HTML 본문. 기본 개인화 코드는 {{이름}}·{{이메일}}이며 기존 영문 기본 코드도 계속 지원합니다."},"senderName":{"type":["string","null"]},"senderEmail":{"type":["string","null"]},"replyTo":{"type":["string","null"]},"previewText":{"type":["string","null"]},"campaignType":{"type":"string","enum":["newsletter","ad"]},"folderId":{"type":["integer","null"],"minimum":1},"recipients":{"type":"object","properties":{"groups":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000},"segments":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000},"excludeGroups":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000},"excludeSegments":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000}}},"attachmentIds":{"type":"array","items":{"type":"string","format":"uuid"},"uniqueItems":true,"description":"업로드한 첨부 ID. 생략하면 유지하고 []는 모두 해제합니다."},"status":{"type":"string"},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":["string","null"],"format":"uuid"},"fileName":{"type":"string"},"contentType":{"type":"string"},"size":{"type":"integer","minimum":0},"sha256":{"type":["string","null"]}},"required":["id","fileName","contentType","size","sha256"]}},"sendCount":{"type":"integer","minimum":0},"successCount":{"type":"integer","minimum":0},"openCount":{"type":"integer","minimum":0},"clickCount":{"type":"integer","minimum":0},"scheduleAt":{"type":["string","null"],"format":"date-time"},"sentAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","title","subject","status"]},"Group":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string"},"description":{"type":["string","null"]},"total":{"type":"integer","minimum":0},"active":{"type":"integer","minimum":0},"unsubscribed":{"type":"integer","minimum":0},"bounced":{"type":"integer","minimum":0},"isFavorite":{"type":"boolean"},"isDefault":{"type":"boolean"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","name"]},"Subscriber":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"email":{"type":"string","format":"email","maxLength":254},"marketingAllowed":{"type":["boolean","null"],"description":"광고성 정보 수신 동의. 미기록은 null"},"name":{"type":"string"},"phone":{"type":"string"},"memo":{"type":"string"},"source":{"type":["string","null"]},"status":{"type":"string"},"groups":{"type":"array","items":{"type":"string"}},"customFields":{"type":["object","null"],"additionalProperties":true},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","email","status"]},"SubscriberInput":{"type":"object","properties":{"email":{"type":"string","format":"email","maxLength":254},"marketingAllowed":{"type":"boolean"},"status":{"type":"string","enum":["active","subscribed","unsubscribed"],"default":"active","description":"신규 등록 상태. 기존 구독 상태는 상태 변경 API를 사용합니다."},"name":{"type":"string"},"phone":{"type":"string","description":"사전 등록 필수: 주소록 필드(정보항목)에서 연락처(code: phone)를 먼저 생성합니다. 미등록 값은 400으로 거절합니다. 테스트·운영에 동일하게 적용됩니다."},"memo":{"type":"string","description":"사전 등록 필수: 주소록 필드(정보항목)에서 메모(code: memo)를 먼저 생성합니다. 미등록 값은 400으로 거절합니다. 테스트·운영에 동일하게 적용됩니다."},"source":{"type":"string"},"customFields":{"type":"object","additionalProperties":true,"description":"등록된 추가 필드(정보항목) 이름 또는 코드. 기본 이름·이메일은 name·email로 전달하며 메일의 기본 개인화 코드는 {{이름}}·{{이메일}}입니다. 연락처·메모·회사명·직함 등 추가 정보는 해당 항목을 등록한 뒤 입력합니다. 생략한 기존 값은 보존합니다."}},"required":["email"]},"Automation":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string"},"description":{"type":["string","null"]},"status":{"type":"string","enum":["draft","active","paused","ended"]},"pauseMode":{"type":"string","enum":["entry_only","all"],"description":"일시정지 상태에서만 반환합니다. entry_only는 신규 진입만, all은 기존 진행과 대기 발송도 일시정지합니다."},"statusLabel":{"type":"string"},"triggerType":{"type":["string","null"]},"totalEntered":{"type":"integer","minimum":0},"totalCompleted":{"type":"integer","minimum":0},"totalDropped":{"type":"integer","minimum":0},"lastRunAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"sourceTemplateId":{"type":["string","null"]},"triggerConditions":{"type":"object","additionalProperties":true},"steps":{"type":"array","items":{"type":"object","additionalProperties":true}},"activationStartsAt":{"type":["string","null"],"format":"date-time"},"activationEndsAt":{"type":["string","null"],"format":"date-time"},"activationNoEnd":{"type":"boolean"}},"required":["id","name","status"]},"ConsentReview":{"type":"object","properties":{"snapshot":{"type":"string","pattern":"^[a-f0-9]{64}$"},"includeEmails":{"type":"array","items":{"type":"string","format":"email","maxLength":254},"maxItems":1000}},"required":["snapshot","includeEmails"]},"SendJob":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"userIdx":{"type":"integer","minimum":1,"maximum":2147483647},"campaignId":{"type":"integer","minimum":1,"maximum":2147483647},"subject":{"type":["string","null"],"description":"발송 작업 접수 시 저장한 기본 이메일 제목. 현재 캠페인·템플릿의 수정과 무관하며, A/B에서는 승자나 두 버전 전체를 대표하는 제목이 아님. 제목이 없는 과거 작업은 null"},"variantSubjects":{"type":["object","null"],"properties":{"a":{"type":["string","null"]},"b":{"type":["string","null"]}},"required":["a","b"],"additionalProperties":false,"description":"일반 발송은 null. A/B는 접수 시 저장한 버전별 이메일 제목 {a,b}. 없는 제목이나 구분할 수 없는 버전은 null이며 현재 캠페인 제목으로 대체하지 않음"},"status":{"type":"string","enum":["scheduled","sending","completed","failed","cancelled"]},"scheduledAt":{"type":["string","null"],"format":"date-time"},"recipientCount":{"type":"integer","minimum":0},"successCount":{"type":"integer","minimum":0},"failureCount":{"type":"integer","minimum":0},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"cancelledAt":{"type":["string","null"],"format":"date-time"}},"required":["id","campaignId","status","subject","variantSubjects"]},"Webhook":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"credentialId":{"type":"integer","minimum":1,"maximum":2147483647},"url":{"type":"string","format":"uri"},"events":{"type":"array","items":{"type":"string","enum":["send.completed","send.failed","subscriber.created","subscriber.updated","subscriber.unsubscribed","subscriber.resubscribed","subscriber.deleted"]},"minItems":1,"uniqueItems":true},"active":{"type":"boolean"},"responseVerification":{"type":"string","enum":["http_status","receipt_v1"],"description":"http_status: HTTP 2xx로 성공 확인. receipt_v1: 저장 완료 후 HTTP 2xx 응답 본문에 EZSENDER_RECEIPT_V1:<eventUUID>:<sha256(raw request body)> 반환 필요. 해시는 가공 전 UTF-8 요청 본문의 SHA-256 소문자 16진수. 압축하지 않은 64KiB 이내 일반 텍스트 및 Google HtmlService HTML 응답 지원. 확인값 누락·불일치는 HTTP 200이어도 실패"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","url","events","active","responseVerification"]},"WebhookDelivery":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"eventId":{"type":"string","format":"uuid"},"eventType":{"type":"string","enum":["send.completed","send.failed","subscriber.created","subscriber.updated","subscriber.unsubscribed","subscriber.resubscribed","subscriber.deleted"]},"status":{"type":"string","enum":["pending","delivering","delivered","failed","cancelled"]},"attempts":{"type":"integer","minimum":0},"lastStatusCode":{"type":["integer","null"]},"lastError":{"type":["string","null"]},"nextAttemptAt":{"type":["string","null"],"format":"date-time"},"deliveredAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":["string","null"],"format":"date-time"}},"required":["id","eventId","eventType","status","attempts"]},"SegmentCondition":{"type":"object","properties":{"id":{"type":"string"},"field":{"type":"string","enum":["email","name","phone","memo","source","custom_field","group","email_status","created_at","unsubscribed_at"]},"operator":{"type":"string","enum":["equals","not_equals","contains","not_contains","starts_with","ends_with","is_empty","is_not_empty","belongs_to","not_belongs_to","before","after","on","between"]},"value":{"type":"string","maxLength":1000},"customStorageKey":{"type":"string","maxLength":100}},"required":["field","operator"],"additionalProperties":false},"Segment":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":2000},"conditions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"conditions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"field":{"type":"string","enum":["email","name","phone","memo","source","custom_field","group","email_status","created_at","unsubscribed_at"]},"operator":{"type":"string","enum":["equals","not_equals","contains","not_contains","starts_with","ends_with","is_empty","is_not_empty","belongs_to","not_belongs_to","before","after","on","between"]},"value":{"type":"string","maxLength":1000},"customStorageKey":{"type":"string","maxLength":100}},"required":["field","operator"],"additionalProperties":false},"minItems":1,"maxItems":100}},"required":["conditions"]},"minItems":1,"maxItems":20},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","name","conditions"]},"CustomField":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","minLength":1,"maxLength":100},"type":{"type":"string","enum":["text","number","date","datetime","dropdown","link"],"default":"text"},"code":{"type":"string","pattern":"^\\{\\{(?!\\s)[^{}\\u0000-\\u001F\\u007F-\\u009F]+(?<!\\s)\\}\\}$","maxLength":100},"defaultValue":{"type":["string","null"],"maxLength":1000},"isDefault":{"type":"boolean","description":"이름·이메일의 전역 기본 항목만 true입니다."},"isGlobal":{"type":"boolean"},"bindingLocked":{"type":"boolean","description":"시스템에서 관리하는 고정 코드이면 true입니다."},"displayOrder":{"type":"integer"}},"required":["id","name","type","code","isDefault","isGlobal"]},"SubscriberActivity":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["email_sent","email_failed","email_bounced","email_opened","email_clicked","email_unsubscribed"]},"timestamp":{"type":["string","null"],"format":"date-time"},"date":{"type":"string"},"time":{"type":"string"},"description":{"type":"string"},"details":{"type":"array","items":{"type":"string"}},"timeSource":{"type":"string","enum":["event","send","record","unknown"]},"logId":{"type":"integer","minimum":1,"maximum":2147483647},"campaignId":{"type":"integer","minimum":1,"maximum":2147483647},"campaignTitle":{"type":"string"}},"required":["id","type","timestamp","timeSource","logId","campaignId"]},"HardBounce":{"type":"object","properties":{"subscriberId":{"type":"integer","minimum":1,"maximum":2147483647},"email":{"type":"string","format":"email"},"name":{"type":"string"},"bouncedAt":{"type":["string","null"],"format":"date-time"},"reason":{"type":"string"},"category":{"type":"string"},"logId":{"type":"integer","minimum":1,"maximum":2147483647}},"required":["subscriberId","email","logId"]},"FormConfig":{"type":"object","properties":{"purpose":{"type":"string","enum":["general","webinar","resource","consultation","event"],"default":"general"},"title":{"type":"string","maxLength":150},"description":{"type":"string","maxLength":15000},"imageUrl":{"type":"string"},"eventAt":{"type":["string","null"],"format":"date-time"},"location":{"type":"string","maxLength":300},"buttonText":{"type":"string","maxLength":50},"accentColor":{"type":"string","pattern":"^#[a-fA-F0-9]{6}$"},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_-]*$","maxLength":64},"label":{"type":"string","maxLength":100},"type":{"type":"string","enum":["email","text","tel","textarea","select","checkbox"]},"required":{"type":"boolean"},"options":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":30},"placeholder":{"type":"string","maxLength":200},"appearance":{"type":"object","additionalProperties":true}},"required":["id","label","type","required"]},"minItems":1,"maxItems":20},"privacyText":{"type":"string","maxLength":10000},"marketingEnabled":{"type":"boolean"},"marketingText":{"type":"string","maxLength":10000},"successTitle":{"type":"string","maxLength":150},"successMessage":{"type":"string","maxLength":3000},"successLinkLabel":{"type":"string","maxLength":100},"successLinkUrl":{"type":"string"},"closesAt":{"type":["string","null"],"format":"date-time"},"followUp":{"type":"object","properties":{"enabled":{"type":"boolean"},"sourceCampaignId":{"type":["integer","null"],"minimum":1},"timing":{"type":"string","enum":["immediate","scheduled","delayed"]},"scheduledAt":{"type":["string","null"],"format":"date-time"},"latePolicy":{"type":"string","enum":["send_immediately","skip"]},"delayAmount":{"type":"integer","minimum":1,"description":"delayed 모드에서 필수. delayUnit과 합해 최대 365일."},"delayUnit":{"type":"string","enum":["minutes","hours","days"]},"mail":{"oneOf":[{"type":"object","properties":{"version":{"const":1},"title":{"type":"string"},"subject":{"type":"string"},"senderName":{"type":"string"},"senderEmail":{"type":"string"},"replyTo":{"type":"string"},"previewText":{"type":"string"},"html":{"type":"string"},"description":{"type":"string"},"sourceCampaignId":{"type":["integer","null"]},"campaignType":{"type":"string","enum":["newsletter","ad"]}},"required":[]},{"type":"null"}]}},"required":["enabled","sourceCampaignId","timing","scheduledAt","latePolicy"]},"formTitle":{"type":"string","maxLength":150},"successLinkEnabled":{"type":"boolean"},"design":{"type":"object","additionalProperties":true},"contentSections":{"type":"array","items":{"type":"object","additionalProperties":true}},"titleRichText":{"type":"object","additionalProperties":true},"descriptionRichText":{"type":"object","additionalProperties":true},"formTitleRichText":{"type":"object","additionalProperties":true},"imageProperties":{"type":"object","additionalProperties":true},"elementStyles":{"type":"object","additionalProperties":true},"submitStyle":{"type":"object","additionalProperties":true}},"required":["purpose","title","description","imageUrl","eventAt","location","buttonText","accentColor","fields","privacyText","marketingEnabled","marketingText","successTitle","successMessage","successLinkLabel","successLinkUrl","closesAt","followUp"]},"Form":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"shortCode":{"type":["string","null"],"pattern":"^[A-Za-z0-9_-]{8}$"},"title":{"type":"string"},"status":{"type":"string","enum":["draft","published","closed"]},"draft":{"$ref":"#/components/schemas/FormConfig"},"published":{"oneOf":[{"$ref":"#/components/schemas/FormConfig"},{"type":"null"}]},"revision":{"type":"integer","minimum":1},"publishedRevision":{"type":["integer","null"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"contactSyncEnabled":{"type":"boolean"},"entryCount":{"type":"integer","minimum":0},"visitCount":{"type":"integer","minimum":0}},"required":["id","slug","title","status","draft","published","revision","publishedRevision","createdAt","updatedAt"]},"FormListItem":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"shortCode":{"type":["string","null"],"pattern":"^[A-Za-z0-9_-]{8}$"},"title":{"type":"string"},"status":{"type":"string","enum":["draft","published","closed"]},"revision":{"type":"integer","minimum":1},"publishedRevision":{"type":["integer","null"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"entryCount":{"type":"integer","minimum":0},"visitCount":{"type":"integer","minimum":0},"hasUnpublishedChanges":{"type":"boolean"},"published":{"oneOf":[{"type":"object","properties":{"closesAt":{"type":["string","null"],"format":"date-time"}},"required":["closesAt"]},{"type":"null"}]}},"required":["id","title","status","revision","entryCount","visitCount"]},"FormEntry":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"pageId":{"type":"string","format":"uuid"},"email":{"type":"string","format":"email"},"name":{"type":"string"},"answers":{"type":"object","additionalProperties":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string","maxLength":200},"maxItems":30,"uniqueItems":true}]}},"formSnapshot":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_-]*$","maxLength":64},"label":{"type":"string","maxLength":100},"type":{"type":"string","enum":["email","text","tel","textarea","select","checkbox"]},"required":{"type":"boolean"},"options":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":30},"placeholder":{"type":"string","maxLength":200},"appearance":{"type":"object","additionalProperties":true}},"required":["id","label","type","required"]}},"privacyAgreed":{"type":"boolean"},"marketingAgreed":{"type":"boolean"},"privacyText":{"type":"string"},"marketingText":{"type":"string"},"submittedAt":{"type":"string","format":"date-time"},"attribution":{"type":"object","properties":{"first":{"type":"object","properties":{"key":{"type":"string"},"kind":{"type":"string","enum":["email","automation","distribution","referral","unknown"]},"label":{"type":"string"},"evidence":{"type":"string","enum":["verified_email_link","distribution_link","referrer","unavailable"]},"campaignId":{"type":"integer","minimum":1},"campaignName":{"type":"string"},"mailLogId":{"type":"integer","minimum":1},"linkPosition":{"type":"integer","minimum":0},"workflowId":{"type":"integer","minimum":1},"workflowName":{"type":"string"},"stepId":{"type":"string"},"executionId":{"type":"integer","minimum":1},"distributionLinkId":{"type":"string","format":"uuid"},"channel":{"type":"string"},"referrerHost":{"type":"string"}},"required":["key","kind","label","evidence"]},"visit":{"type":"object","properties":{"key":{"type":"string"},"kind":{"type":"string","enum":["email","automation","distribution","referral","unknown"]},"label":{"type":"string"},"evidence":{"type":"string","enum":["verified_email_link","distribution_link","referrer","unavailable"]},"campaignId":{"type":"integer","minimum":1},"campaignName":{"type":"string"},"mailLogId":{"type":"integer","minimum":1},"linkPosition":{"type":"integer","minimum":0},"workflowId":{"type":"integer","minimum":1},"workflowName":{"type":"string"},"stepId":{"type":"string"},"executionId":{"type":"integer","minimum":1},"distributionLinkId":{"type":"string","format":"uuid"},"channel":{"type":"string"},"referrerHost":{"type":"string"}},"required":["key","kind","label","evidence"]},"credited":{"type":"object","properties":{"key":{"type":"string"},"kind":{"type":"string","enum":["email","automation","distribution","referral","unknown"]},"label":{"type":"string"},"evidence":{"type":"string","enum":["verified_email_link","distribution_link","referrer","unavailable"]},"campaignId":{"type":"integer","minimum":1},"campaignName":{"type":"string"},"mailLogId":{"type":"integer","minimum":1},"linkPosition":{"type":"integer","minimum":0},"workflowId":{"type":"integer","minimum":1},"workflowName":{"type":"string"},"stepId":{"type":"string"},"executionId":{"type":"integer","minimum":1},"distributionLinkId":{"type":"string","format":"uuid"},"channel":{"type":"string"},"referrerHost":{"type":"string"}},"required":["key","kind","label","evidence"]},"visitId":{"type":["string","null"],"format":"uuid"},"observedAt":{"type":"string","format":"date-time"},"model":{"const":"last_non_direct_30d"}},"required":["first","visit","credited","visitId","observedAt","model"]},"delivery":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["scheduled","queued","sent","failed","skipped","unknown","cancelled"]},"scheduledAt":{"type":["string","null"],"format":"date-time"},"sentAt":{"type":["string","null"],"format":"date-time"},"error":{"type":["string","null"]},"campaignId":{"type":["integer","null"]}},"required":["id","status","scheduledAt","sentAt","error"]},{"type":"null"}]},"timeline":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","format":"date-time"},"source":{"type":"object","properties":{"key":{"type":"string"},"kind":{"type":"string","enum":["email","automation","distribution","referral","unknown"]},"label":{"type":"string"},"evidence":{"type":"string","enum":["verified_email_link","distribution_link","referrer","unavailable"]},"campaignId":{"type":"integer","minimum":1},"campaignName":{"type":"string"},"mailLogId":{"type":"integer","minimum":1},"linkPosition":{"type":"integer","minimum":0},"workflowId":{"type":"integer","minimum":1},"workflowName":{"type":"string"},"stepId":{"type":"string"},"executionId":{"type":"integer","minimum":1},"distributionLinkId":{"type":"string","format":"uuid"},"channel":{"type":"string"},"referrerHost":{"type":"string"}},"required":["key","kind","label","evidence"]}},"required":[]}},"contactSyncStatus":{"type":"string","enum":["not_requested","no_consent","connected","existing","updated","stale","invalid","suppressed","limit_reached","failed"]}},"required":["id","pageId","email","answers","privacyAgreed","marketingAgreed","submittedAt","attribution","delivery"]},"FormDistributionLink":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"channel":{"type":"string"},"token":{"type":"string"},"createdAt":{"type":"string","format":"date-time"}},"required":["id","name","channel","token","createdAt"]},"FormDeletionPreview":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"status":{"type":"string","enum":["draft","published","closed"]},"expectedRevision":{"type":"integer","minimum":1},"entryCount":{"type":"integer","minimum":0},"visitCount":{"type":"integer","minimum":0},"distributionLinkCount":{"type":"integer","minimum":0},"segmentCount":{"type":"integer","minimum":0},"scheduledMailCount":{"type":"integer","minimum":0},"handedOffMailCount":{"type":"integer","minimum":0},"pendingStaffNotificationCount":{"type":"integer","minimum":0},"handedOffStaffNotificationCount":{"type":"integer","minimum":0},"confirmationToken":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["id","expectedRevision","confirmationToken","entryCount","scheduledMailCount","handedOffMailCount"]},"FormReportWindow":{"type":"object","properties":{"period":{"type":"string","enum":["all","7d","30d","90d","180d","365d"]},"from":{"type":["string","null"],"format":"date-time"},"to":{"type":"string","format":"date-time"},"cohort":{"const":"applications_submitted"},"outcomes":{"const":"current"}},"required":["period","from","to","cohort","outcomes"]},"Message":{"type":"object","required":["id","status","to","subject","createdAt","acceptedAt","error"],"properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","sending","accepted","failed","unknown"],"description":"queued: 접수·대기, sending: 처리 중, accepted: SMTP 서버 접수, failed: 실패, unknown: 전송 결과 불명확. accepted는 받은편지함 도착을 보장하지 않습니다."},"to":{"type":"object","required":["email","name"],"additionalProperties":false,"properties":{"email":{"type":"string","format":"email","maxLength":254},"name":{"type":"string","maxLength":100}}},"subject":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"acceptedAt":{"type":["string","null"],"format":"date-time"},"error":{"type":["object","null"],"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"Attachment":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"fileName":{"type":"string"},"contentType":{"type":"string"},"size":{"type":"integer","minimum":1,"maximum":5242880},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"createdAt":{"type":"string","format":"date-time"}},"required":["id","fileName","contentType","size","sha256","createdAt"]},"CampaignReport":{"type":"object","properties":{"campaignId":{"type":"integer","minimum":1},"title":{"type":"string"},"status":{"type":"string"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"delivery":{"type":"object","properties":{"records":{"type":"integer","minimum":0},"succeeded":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"pending":{"type":"integer","minimum":0},"unsubscribed":{"type":"integer","minimum":0}},"required":[]},"engagement":{"type":"object","properties":{"uniqueRecipients":{"type":["integer","null"],"minimum":0},"uniqueDelivered":{"type":["integer","null"],"minimum":0},"uniqueOpeners":{"type":["integer","null"],"minimum":0},"uniqueClickers":{"type":["integer","null"],"minimum":0},"totalClicks":{"type":"integer","minimum":0},"clickRateFromDelivered":{"type":["number","null"]},"openRateFromDelivered":{"type":["number","null"]}},"required":[]},"asOf":{"type":["string","null"],"format":"date-time"}},"required":[]}},"securitySchemes":{"ezsenderId":{"type":"apiKey","in":"header","name":"X-EZSENDER-ID"},"ezsenderSecret":{"type":"apiKey","in":"header","name":"X-EZSENDER-SECRET"}}},"paths":{"/auth-check":{"get":{"tags":["인증"],"operationId":"auth-check","summary":"인증 확인","description":"발급된 API ID와 secret key 조합이 유효한지 확인합니다.\n운영 제공: 모든 요금제. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"authenticated":true,"apiKeyId":"ez_xxx","userIdx":1},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"authenticated":{"type":"boolean"},"apiKeyId":{"type":"string"},"userIdx":{"type":"integer","minimum":1,"maximum":2147483647},"environment":{"type":"string","enum":["test","live"]},"scopes":{"type":"array","items":{"type":"string"}}},"required":["success","authenticated"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":null,"x-additional-required-scopes":[],"x-required-live-plan":"free","x-live-plan-description":"모든 요금제","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/campaigns":{"get":{"tags":["이메일 캠페인"],"operationId":"campaign-list","summary":"이메일 캠페인 목록조회","description":"캠페인을 최신 생성순으로 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2147483647,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"ids","in":"query","required":false,"schema":{"type":"string","description":"최대 100개 ID를 쉼표로 구분"}},{"name":"statuses","in":"query","required":false,"schema":{"type":"string","description":"최대 20개 상태를 쉼표로 구분"}},{"name":"campaignTypes","in":"query","required":false,"schema":{"type":"string","description":"ad,newsletter"}},{"name":"tag","in":"query","required":false,"schema":{"type":"string","maxLength":50}},{"name":"addressBookId","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"sentAfter","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"sentBefore","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string","enum":["createdAt","updatedAt","sentAt"],"default":"createdAt"}},{"name":"sortOrder","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"campaigns":[{"id":10,"title":"7월 뉴스레터","subject":"새 소식입니다","status":"draft"}],"pagination":{"page":1,"limit":20,"total":1,"totalPages":1}},"schema":{"type":"object","properties":{"campaigns":{"type":"array","items":{"$ref":"#/components/schemas/Campaign"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["campaigns","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"post":{"tags":["이메일 캠페인"],"operationId":"campaign-create","summary":"이메일 캠페인 생성","description":"작성중 상태의 이메일 캠페인을 생성합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"title":"7월 뉴스레터","subject":"새 소식입니다","html":"<h1>Hello</h1>","recipients":{"groups":[1],"segments":[]}},"schema":{"type":"object","properties":{"title":{"type":"string","description":"생략하면 subject 사용"},"subject":{"type":"string","minLength":1,"description":"이메일 제목. {{이름}}·{{이메일}}과 등록한 필드(정보항목) 코드를 사용할 수 있습니다."},"html":{"type":"string","description":"이메일 HTML 본문. 기본 개인화 코드는 {{이름}}·{{이메일}}이며 기존 영문 기본 코드도 계속 지원합니다."},"senderName":{"type":"string"},"senderEmail":{"type":"string","format":"email","maxLength":254},"replyTo":{"type":"string","format":"email","maxLength":254},"previewText":{"type":"string","description":"받은편지함 미리보기 문구. {{이름}}·{{이메일}}과 등록한 필드(정보항목) 코드를 사용할 수 있습니다."},"campaignType":{"type":"string","enum":["newsletter","ad"]},"folderId":{"type":["integer","null"],"minimum":1},"recipients":{"type":"object","properties":{"groups":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000},"segments":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000},"excludeGroups":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000},"excludeSegments":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000}}},"attachmentIds":{"type":"array","items":{"type":"string","format":"uuid"},"uniqueItems":true,"description":"업로드한 첨부 ID. 생략하면 유지하고 []는 모두 해제합니다."}},"required":["subject"]}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"campaign":{"id":10,"title":"7월 뉴스레터","subject":"새 소식입니다","status":"draft"}},"schema":{"type":"object","properties":{"campaign":{"$ref":"#/components/schemas/Campaign"}},"required":["campaign"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/campaigns/{id}":{"get":{"tags":["이메일 캠페인"],"operationId":"campaign-detail","summary":"이메일 캠페인 상세내용 조회","description":"캠페인 본문과 수신 대상 설정을 함께 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"campaign":{"id":10,"title":"7월 뉴스레터","status":"draft","subject":"새 소식입니다","html":"<h1>Hello</h1>","recipients":{"groups":[1]}}},"schema":{"type":"object","properties":{"campaign":{"$ref":"#/components/schemas/Campaign"}},"required":["campaign"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"patch":{"tags":["이메일 캠페인"],"operationId":"campaign-update","summary":"이메일 캠페인 수정","description":"작성중 캠페인의 제목, 본문, 발신자, 수신 대상 등을 수정합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"subject":"수정된 제목","html":"<p>Updated</p>"},"schema":{"type":"object","properties":{"title":{"type":"string","description":"생략하면 subject 사용"},"subject":{"type":"string","minLength":1,"description":"이메일 제목. {{이름}}·{{이메일}}과 등록한 필드(정보항목) 코드를 사용할 수 있습니다."},"html":{"type":"string","description":"이메일 HTML 본문. 기본 개인화 코드는 {{이름}}·{{이메일}}이며 기존 영문 기본 코드도 계속 지원합니다."},"senderName":{"type":"string"},"senderEmail":{"type":"string","format":"email","maxLength":254},"replyTo":{"type":"string","format":"email","maxLength":254},"previewText":{"type":"string","description":"받은편지함 미리보기 문구. {{이름}}·{{이메일}}과 등록한 필드(정보항목) 코드를 사용할 수 있습니다."},"campaignType":{"type":"string","enum":["newsletter","ad"]},"folderId":{"type":["integer","null"],"minimum":1},"recipients":{"type":"object","properties":{"groups":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000},"segments":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000},"excludeGroups":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000},"excludeSegments":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000}}},"attachmentIds":{"type":"array","items":{"type":"string","format":"uuid"},"uniqueItems":true,"description":"업로드한 첨부 ID. 생략하면 유지하고 []는 모두 해제합니다."}}}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"campaign":{"id":10,"title":"7월 뉴스레터","status":"draft","subject":"수정된 제목"}},"schema":{"type":"object","properties":{"campaign":{"$ref":"#/components/schemas/Campaign"}},"required":["campaign"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["이메일 캠페인"],"operationId":"campaign-delete","summary":"이메일 캠페인 삭제","description":"캠페인을 삭제합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"deletedId":10},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"deletedId":{"type":"integer","minimum":1,"maximum":2147483647}},"required":["success","deletedId"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/campaigns/{id}/copy":{"post":{"tags":["이메일 캠페인"],"operationId":"campaign-copy","summary":"이메일 캠페인 복사","description":"기존 캠페인과 수신 대상 설정을 복사해 새 작성중 캠페인을 만듭니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"campaign":{"id":11,"title":"7월 뉴스레터 (2)","subject":"새 소식입니다","status":"draft"}},"schema":{"type":"object","properties":{"campaign":{"$ref":"#/components/schemas/Campaign"}},"required":["campaign"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/campaigns/{id}/test-send":{"post":{"tags":["이메일 캠페인"],"operationId":"campaign-test-send","summary":"이메일 캠페인 메일 테스트 발송","description":"캠페인 본문을 지정한 이메일 주소로 테스트 발송합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"to":["test@example.com"]},"schema":{"type":"object","properties":{"to":{"oneOf":[{"type":"string","format":"email","maxLength":254},{"type":"array","items":{"type":"string","format":"email","maxLength":254},"minItems":1,"maxItems":5}]},"variant":{"type":"string","enum":["a","b"],"default":"a"}},"required":["to"]}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"recipients":["test@example.com"],"server":"primary-mail"},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"recipients":{"type":"array","items":{"type":"string","format":"email","maxLength":254},"maxItems":1000},"server":{"type":"string"}},"required":["success","recipients"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:send","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/address-books/groups":{"get":{"tags":["주소록 그룹"],"operationId":"group-list","summary":"주소록 그룹 목록조회","description":"주소록 그룹과 그룹별 수신자 수를 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"groups":[{"id":1,"name":"기본 그룹","active":100,"total":102}]},"schema":{"type":"object","properties":{"groups":{"type":"array","items":{"$ref":"#/components/schemas/Group"}}},"required":["groups"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"address_books:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"post":{"tags":["주소록 그룹"],"operationId":"group-create","summary":"주소록 그룹 생성","description":"새 주소록 그룹을 생성합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"VIP 고객","description":"고가치 고객 그룹"},"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"description":{"type":"string"}},"required":["name"]}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"group":{"id":2,"name":"VIP 고객"}},"schema":{"type":"object","properties":{"group":{"$ref":"#/components/schemas/Group"}},"required":["group"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"address_books:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/address-books/groups/{id}":{"patch":{"tags":["주소록 그룹"],"operationId":"group-update","summary":"주소록 그룹명 수정","description":"그룹 이름 또는 설명을 수정합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"VIP 고객 2026"},"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"description":{"type":"string"}}}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"group":{"id":2,"name":"VIP 고객 2026"}},"schema":{"type":"object","properties":{"group":{"$ref":"#/components/schemas/Group"}},"required":["group"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"address_books:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["주소록 그룹"],"operationId":"group-delete","summary":"주소록 그룹 삭제","description":"주소록 그룹을 삭제합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"deleteSubscribers":false},"schema":{"type":"object","properties":{"deleteSubscribers":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"deletedId":2},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"deletedId":{"type":"integer","minimum":1,"maximum":2147483647}},"required":["success","deletedId"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"address_books:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/subscribers":{"get":{"tags":["수신자"],"operationId":"subscriber-list","summary":"수신자 목록 조회","description":"수신자 목록을 이메일 기준으로 조회합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2147483647,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"groupId","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"subscribers":[{"id":100,"email":"user@example.com","status":"active","groups":["기본 그룹"]}],"pagination":{"page":1,"limit":100,"total":1,"totalPages":1}},"schema":{"type":"object","properties":{"subscribers":{"type":"array","items":{"$ref":"#/components/schemas/Subscriber"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["subscribers","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"subscribers:read","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"reports","limit":100,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"post":{"tags":["수신자"],"operationId":"subscriber-add","summary":"수신자 추가","description":"지정한 그룹에 수신자를 추가하거나 기존 정보를 갱신합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"groupName":"기본 그룹","subscribers":[{"email":"user@example.com","name":"홍길동"}]},"schema":{"type":"object","properties":{"groupId":{"type":"integer","minimum":1,"maximum":2147483647},"groupName":{"type":"string"},"subscribers":{"type":"array","items":{"$ref":"#/components/schemas/SubscriberInput"},"minItems":1,"maxItems":1000},"subscriber":{"$ref":"#/components/schemas/SubscriberInput"},"updateExisting":{"type":"boolean","default":true,"description":"false이면 기존 프로필을 유지합니다."},"updateEnabled":{"type":"boolean","description":"updateExisting의 별칭. 둘을 지정하면 값이 같아야 합니다."},"previewOnly":{"type":"boolean"},"consentReview":{"$ref":"#/components/schemas/ConsentReview"}},"anyOf":[{"required":["subscribers"]},{"required":["subscriber"]}]}}}},"responses":{"200":{"description":"previewOnly:true 수신거부 확인","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"inserted":{"type":"integer","minimum":0},"updated":{"type":"integer","minimum":0},"skippedExisting":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"errors":{"type":"array","items":{"type":"string"}},"skipped_unsubscribed":{"type":"integer","minimum":0},"resubscribed":{"type":"integer","minimum":0},"requiresConfirmation":{"type":"boolean"},"consentReview":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"snapshot":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string","format":"email","maxLength":254}},"required":["email"]}}}}},"required":["success"]}}}},"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"inserted":1,"updated":0,"failed":0},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"inserted":{"type":"integer","minimum":0},"updated":{"type":"integer","minimum":0},"skippedExisting":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"errors":{"type":"array","items":{"type":"string"}},"skipped_unsubscribed":{"type":"integer","minimum":0},"resubscribed":{"type":"integer","minimum":0},"requiresConfirmation":{"type":"boolean"},"consentReview":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"snapshot":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string","format":"email","maxLength":254}},"required":["email"]}}}}},"required":["success"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"수신거부 재등록 확인 필요. consentReview를 확인하세요.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string"},"requiresConfirmation":{"type":"boolean"},"consentReview":{"type":"object","additionalProperties":true}}}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"subscribers:write","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"subscriber-import","limit":10,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"patch":{"tags":["수신자"],"operationId":"subscriber-status","summary":"수신자 상태 변경","description":"수신자 상태를 active 또는 unsubscribed로 변경합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"emails":["user@example.com"],"status":"unsubscribed"},"schema":{"type":"object","properties":{"subscriberIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000},"emails":{"type":"array","items":{"type":"string","format":"email","maxLength":254},"maxItems":1000},"ids":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000,"description":"subscriberIds의 호환 별칭"},"status":{"type":"string","enum":["active","unsubscribed"]}},"required":["status"],"anyOf":[{"required":["subscriberIds"]},{"required":["emails"]},{"required":["ids"]}],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"updated":1,"status":"unsubscribed"},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"updated":{"type":"integer","minimum":0},"status":{"type":"string"}},"required":["success","updated","status"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"subscribers:write","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["수신자"],"operationId":"subscriber-delete","summary":"수신자 삭제","description":"수신자를 ID 또는 이메일 기준으로 삭제합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"emails":["user@example.com"]},"schema":{"type":"object","properties":{"subscriberIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000},"emails":{"type":"array","items":{"type":"string","format":"email","maxLength":254},"maxItems":1000},"ids":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000,"description":"subscriberIds의 호환 별칭"}},"anyOf":[{"required":["subscriberIds"]},{"required":["emails"]},{"required":["ids"]}],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"deleted":1},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"deleted":{"type":"integer","minimum":0}},"required":["success","deleted"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"subscribers:write","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/automations":{"get":{"tags":["자동화"],"operationId":"automation-list","summary":"자동화 목록조회","description":"자동화 목록을 조회합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2147483647,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["draft","active","paused","ended"]}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"automations":[{"id":3,"name":"웰컴 자동화","status":"active"}],"pagination":{"page":1,"limit":50,"total":1,"totalPages":1}},"schema":{"type":"object","properties":{"automations":{"type":"array","items":{"$ref":"#/components/schemas/Automation"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["automations","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"automations:read","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"post":{"tags":["자동화"],"operationId":"automation-create","summary":"자동화 초안 생성","description":"웹 편집기와 같은 실행 그래프를 작성중 상태로 저장합니다. 기본 시작 조건은 수동 시작입니다.\n운영 제공: 기본 자동화 스탠다드 · 고급 자동화 프로. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"가입 환영 메일","nodes":[]},"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":5000},"trigger":{"type":"object","properties":{"id":{"type":"string"},"type":{"const":"trigger"},"title":{"type":"string"},"config":{"type":"object","additionalProperties":true,"description":"웹 자동화 편집기와 같은 단계별 config. 이메일은 subject, senderName, senderEmail, html/emailBody/previewHtml 등을 사용하며 기본 개인화 코드는 {{이름}}·{{이메일}}입니다. 기존 영문 기본 코드도 계속 지원합니다."}},"required":["id","type","config"]},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":200},"type":{"type":"string","enum":["email","delay","condition","action","notification","webhook","split"]},"title":{"type":"string"},"config":{"type":"object","additionalProperties":true,"description":"웹 자동화 편집기와 같은 단계별 config. 이메일은 subject, senderName, senderEmail, html/emailBody/previewHtml 등을 사용하며 기본 개인화 코드는 {{이름}}·{{이메일}}입니다. 기존 영문 기본 코드도 계속 지원합니다."},"yesNodes":{"type":"array","items":{"type":"object","additionalProperties":true}},"noNodes":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["id","type"]},"maxItems":500},"edges":{"type":"array","items":{"type":"object","additionalProperties":true}},"activationPeriod":{"type":"object","properties":{"from":{"type":["string","null"],"format":"date"},"to":{"type":["string","null"],"format":"date"},"noEnd":{"type":"boolean"}},"required":[]}},"required":["name"],"additionalProperties":false}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"automation":{"id":10,"name":"가입 환영 메일","status":"draft","triggerType":"manual","steps":[]}},"schema":{"type":"object","properties":{"automation":{"$ref":"#/components/schemas/Automation"}},"required":["automation"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"automations:write","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"기본 자동화 스탠다드 · 고급 자동화 프로","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/automations/{id}":{"get":{"tags":["자동화"],"operationId":"automation-detail","summary":"자동화 상세내역","description":"자동화 시작 조건과 단계 구성을 조회합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"automation":{"id":3,"name":"웰컴 자동화","status":"active","steps":[]}},"schema":{"type":"object","properties":{"automation":{"$ref":"#/components/schemas/Automation"}},"required":["automation"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"automations:read","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"patch":{"tags":["자동화"],"operationId":"automation-update","summary":"자동화 초안 수정","description":"작성중 자동화만 수정합니다. 활성화 이후의 그래프와 기존 대기열은 변경할 수 없습니다.\n운영 제공: 기본 자동화 스탠다드 · 고급 자동화 프로. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"수정한 자동화"},"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":5000},"trigger":{"type":"object","properties":{"id":{"type":"string"},"type":{"const":"trigger"},"title":{"type":"string"},"config":{"type":"object","additionalProperties":true,"description":"웹 자동화 편집기와 같은 단계별 config. 이메일은 subject, senderName, senderEmail, html/emailBody/previewHtml 등을 사용하며 기본 개인화 코드는 {{이름}}·{{이메일}}입니다. 기존 영문 기본 코드도 계속 지원합니다."}},"required":["id","type","config"]},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":200},"type":{"type":"string","enum":["email","delay","condition","action","notification","webhook","split"]},"title":{"type":"string"},"config":{"type":"object","additionalProperties":true,"description":"웹 자동화 편집기와 같은 단계별 config. 이메일은 subject, senderName, senderEmail, html/emailBody/previewHtml 등을 사용하며 기본 개인화 코드는 {{이름}}·{{이메일}}입니다. 기존 영문 기본 코드도 계속 지원합니다."},"yesNodes":{"type":"array","items":{"type":"object","additionalProperties":true}},"noNodes":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["id","type"]},"maxItems":500},"edges":{"type":"array","items":{"type":"object","additionalProperties":true}},"activationPeriod":{"type":"object","properties":{"from":{"type":["string","null"],"format":"date"},"to":{"type":["string","null"],"format":"date"},"noEnd":{"type":"boolean"}},"required":[]}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"automation":{"id":10,"name":"가입 환영 메일","status":"draft","triggerType":"manual","steps":[]}},"schema":{"type":"object","properties":{"automation":{"$ref":"#/components/schemas/Automation"}},"required":["automation"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"automations:write","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"기본 자동화 스탠다드 · 고급 자동화 프로","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["자동화"],"operationId":"automation-delete","summary":"자동화 삭제","description":"자동화를 숨기고 신규 진입과 진행 중 실행을 중단합니다. 이미 발송한 메일을 회수하지 않습니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"deletedId":10},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"deletedId":{"type":"integer"}},"required":["success","deletedId"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"automations:write","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/automations/{id}/emails":{"post":{"tags":["자동화"],"operationId":"automation-email-add","summary":"자동화 메일 추가","description":"자동화 흐름에 이메일 단계를 추가합니다. previewText로 받은편지함 미리보기 문구를 설정하고 제목·미리보기 문구·본문에 {{이름}}·{{이메일}}과 등록한 필드(정보항목) 코드를 사용할 수 있습니다.\n운영 제공: 기본 자동화 스탠다드 · 고급 자동화 프로. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"title":"첫 인사 메일","subject":"{{이름}}님, 가입을 환영합니다","senderEmail":"sender@your-verified-domain.com","previewText":"{{이름}}님을 위한 첫 소식입니다","html":"<p>{{이름}}님, {{이메일}}로 첫 소식을 전합니다.</p>"},"schema":{"type":"object","properties":{"subject":{"type":"string","minLength":1},"senderEmail":{"type":"string","format":"email","maxLength":254},"senderName":{"type":"string"},"title":{"type":"string"},"html":{"type":"string"},"previewText":{"type":"string","description":"받은편지함 미리보기 문구입니다. {{이름}}·{{이메일}}과 등록한 필드(정보항목) 코드를 사용할 수 있습니다. 생략하면 입력 HTML을 유지하며 빈 문자열은 기존 생성 미리보기 문구를 지웁니다."},"description":{"type":"string"}},"required":["subject","senderEmail"]}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"step":{"type":"email","title":"첫 인사 메일"}},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"step":{"type":"object","properties":{"id":{"type":"string"},"type":{"const":"email"},"title":{"type":"string"},"description":{"type":"string"},"config":{"type":"object","additionalProperties":true}}}},"required":["success","step"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"automations:write","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"기본 자동화 스탠다드 · 고급 자동화 프로","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/automations/{id}/run":{"post":{"tags":["자동화"],"operationId":"automation-run","summary":"자동화 발송 실행","description":"활성 상태의 대상 선택 후 실행 또는 외부 이벤트 시작 자동화를, 발송 가능한 수신자에게 실행합니다.\n운영 제공: 기본 자동화 스탠다드 · 고급 자동화 프로. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}},{"name":"Idempotency-Key","in":"header","required":true,"description":"같은 요청을 재시도할 때 같은 값을 유지합니다. 다른 요청에 재사용하면 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"subscriberIds":[12]},"schema":{"type":"object","properties":{"subscriberIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000},"emails":{"type":"array","items":{"type":"string","format":"email","maxLength":254},"maxItems":1000},"variables":{"type":"object","maxProperties":100,"additionalProperties":{"type":["string","number","boolean"]},"description":"실행에만 적용하는 값. 기본 이름 토큰은 {{이름}}이며 기존 영문 이름 코드도 지원합니다. {{이메일}}은 실제 수신 주소를 사용하므로 덮어쓸 수 없습니다. 최대 100개, 값당 UTF-8 8KiB, 병합 후 수신자당 64KiB. 시스템 이메일·ID·수신거부 변수는 지정할 수 없습니다."},"recipientVariables":{"type":"array","items":{"type":"object","properties":{"subscriberId":{"type":"integer","minimum":1,"maximum":2147483647},"email":{"type":"string","format":"email","maxLength":254},"variables":{"type":"object","maxProperties":100,"additionalProperties":{"type":["string","number","boolean"]},"description":"실행에만 적용하는 값. 기본 이름 토큰은 {{이름}}이며 기존 영문 이름 코드도 지원합니다. {{이메일}}은 실제 수신 주소를 사용하므로 덮어쓸 수 없습니다. 최대 100개, 값당 UTF-8 8KiB, 병합 후 수신자당 64KiB. 시스템 이메일·ID·수신거부 변수는 지정할 수 없습니다."}},"required":["variables"],"additionalProperties":false,"oneOf":[{"required":["subscriberId"],"not":{"required":["email"]}},{"required":["email"],"not":{"required":["subscriberId"]}}]},"maxItems":1000}},"anyOf":[{"required":["subscriberIds"]},{"required":["emails"]}],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"id":3,"status":"active","executionCount":1},"schema":{"type":"object","properties":{"success":{"type":"boolean"},"id":{"type":"integer","minimum":1,"maximum":2147483647},"status":{"type":"string"},"executionCount":{"type":"integer","minimum":0},"skippedReentryCount":{"type":"integer","minimum":0}},"required":["success","id","status","executionCount"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"automations:send","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"기본 자동화 스탠다드 · 고급 자동화 프로","x-rate-limit":{"bucket":"automation-run","limit":3,"windowSeconds":1,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/campaigns/{id}/send-jobs":{"post":{"tags":["발송 작업"],"operationId":"campaign-send-job-create","summary":"발송 작업 접수","description":"요청 키로 중복 접수를 막고 추적 가능한 발송 작업을 만듭니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}},{"name":"Idempotency-Key","in":"header","required":true,"description":"같은 요청을 재시도할 때 같은 값을 유지합니다. 다른 요청에 재사용하면 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"mode":"immediate"},"schema":{"type":"object","properties":{"mode":{"type":"string","enum":["immediate","scheduled"],"default":"immediate"},"scheduledAt":{"type":"string","format":"date-time","description":"scheduled 모드 필수. 미래 시각, Z 또는 +09:00 등 시간대 필수"}}}}}},"responses":{"202":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"accepted":true,"sendJob":{"id":"a112ac74-6e95-4b56-99a4-6fe16f2a8140","userIdx":1,"campaignId":10,"subject":"12월 이지센더 소식","variantSubjects":null,"status":"scheduled","scheduledAt":"2026-12-01T00:00:00.000Z","recipientCount":120,"successCount":0,"failureCount":0,"createdAt":"2026-10-08T02:00:00.000Z","updatedAt":"2026-10-08T02:00:00.000Z","completedAt":null,"cancelledAt":null}},"schema":{"type":"object","properties":{"accepted":{"const":true},"sendJob":{"$ref":"#/components/schemas/SendJob"}},"required":["accepted","sendJob"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:send","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/send-jobs":{"get":{"tags":["발송 작업"],"operationId":"send-job-list","summary":"발송 작업 목록","description":"접수한 발송 작업의 상태와 결과를 조회합니다.\n운영 제공: 모든 요금제. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2147483647,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["scheduled","sending","completed","failed","cancelled"]}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"sendJobs":[{"id":"a112ac74-6e95-4b56-99a4-6fe16f2a8140","userIdx":1,"campaignId":10,"subject":"12월 이지센더 소식","variantSubjects":null,"status":"scheduled","scheduledAt":"2026-12-01T00:00:00.000Z","recipientCount":120,"successCount":0,"failureCount":0,"createdAt":"2026-10-08T02:00:00.000Z","updatedAt":"2026-10-08T02:00:00.000Z","completedAt":null,"cancelledAt":null}],"pagination":{"page":1,"limit":20,"total":1,"totalPages":1}},"schema":{"type":"object","properties":{"sendJobs":{"type":"array","items":{"$ref":"#/components/schemas/SendJob"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["sendJobs","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:read","x-additional-required-scopes":[],"x-required-live-plan":"free","x-live-plan-description":"모든 요금제","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/send-jobs/{id}":{"get":{"tags":["발송 작업"],"operationId":"send-job-detail","summary":"발송 작업 조회","description":"개별 작업의 예약 시각·발송 상태·성공과 실패 수를 확인합니다.\n운영 제공: 모든 요금제. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"sendJob":{"id":"a112ac74-6e95-4b56-99a4-6fe16f2a8140","userIdx":1,"campaignId":10,"subject":"12월 이지센더 소식","variantSubjects":null,"status":"scheduled","scheduledAt":"2026-12-01T00:00:00.000Z","recipientCount":120,"successCount":0,"failureCount":0,"createdAt":"2026-10-08T02:00:00.000Z","updatedAt":"2026-10-08T02:00:00.000Z","completedAt":null,"cancelledAt":null}},"schema":{"type":"object","properties":{"sendJob":{"$ref":"#/components/schemas/SendJob"}},"required":["sendJob"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:read","x-additional-required-scopes":[],"x-required-live-plan":"free","x-live-plan-description":"모든 요금제","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/send-jobs/{id}/cancel":{"post":{"tags":["발송 작업"],"operationId":"send-job-cancel","summary":"발송 예약 취소","description":"발송 처리가 시작되기 전인 예약만 취소합니다.\n운영 제공: 모든 요금제. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"sendJob":{"id":"a112ac74-6e95-4b56-99a4-6fe16f2a8140","userIdx":1,"campaignId":10,"subject":"12월 이지센더 소식","variantSubjects":null,"status":"cancelled","scheduledAt":"2026-12-01T00:00:00.000Z","recipientCount":120,"successCount":0,"failureCount":0,"createdAt":"2026-10-08T02:00:00.000Z","updatedAt":"2026-10-08T02:00:00.000Z","completedAt":null,"cancelledAt":"2026-10-08T02:01:00.000Z"}},"schema":{"type":"object","properties":{"sendJob":{"$ref":"#/components/schemas/SendJob"}},"required":["sendJob"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:send","x-additional-required-scopes":[],"x-required-live-plan":"free","x-live-plan-description":"모든 요금제","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/send-jobs/{id}/reschedule":{"post":{"tags":["발송 작업"],"operationId":"send-job-reschedule","summary":"발송 예약 시각 변경","description":"대상과 내용은 유지하고 아직 시작하지 않은 예약의 시각을 변경합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"scheduledAt":"2026-12-01T09:00:00+09:00"},"schema":{"type":"object","properties":{"scheduledAt":{"type":"string","format":"date-time"}},"required":["scheduledAt"]}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"sendJob":{"id":"a112ac74-6e95-4b56-99a4-6fe16f2a8140","userIdx":1,"campaignId":10,"subject":"12월 이지센더 소식","variantSubjects":null,"status":"scheduled","scheduledAt":"2026-12-01T00:00:00.000Z","recipientCount":120,"successCount":0,"failureCount":0,"createdAt":"2026-10-08T02:00:00.000Z","updatedAt":"2026-10-08T02:00:00.000Z","completedAt":null,"cancelledAt":null}},"schema":{"type":"object","properties":{"sendJob":{"$ref":"#/components/schemas/SendJob"}},"required":["sendJob"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:send","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/webhooks":{"get":{"tags":["결과 알림"],"operationId":"webhook-list","summary":"결과 알림 목록","description":"현재 키의 권한으로 접근 가능한 계정 웹훅을 조회합니다.\n운영 제공: 모든 요금제. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"webhooks":[]},"schema":{"type":"object","properties":{"webhooks":{"type":"array","items":{"$ref":"#/components/schemas/Webhook"}}},"required":["webhooks"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"webhooks:read","x-additional-required-scopes":[],"x-required-live-plan":"free","x-live-plan-description":"모든 요금제","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"post":{"tags":["결과 알림"],"operationId":"webhook-create","summary":"결과 알림 등록","description":"발송 완료·실패 또는 구독취소 결과를 받을 공개 HTTPS 주소를 등록합니다. HTTP 응답 상태 또는 저장 확인값으로 전달 성공을 확인합니다.\n운영 제공: 수신자 알림 스탠다드 · 발송 알림 프로. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"url":"https://your-service.example/ezsender/events","events":["send.completed","send.failed"],"responseVerification":"http_status"},"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"공개 HTTPS URL"},"events":{"type":"array","items":{"type":"string","enum":["send.completed","send.failed","subscriber.created","subscriber.updated","subscriber.unsubscribed","subscriber.resubscribed","subscriber.deleted"]},"minItems":1,"uniqueItems":true},"responseVerification":{"type":"string","enum":["http_status","receipt_v1"],"description":"http_status: HTTP 2xx로 성공 확인. receipt_v1: 저장 완료 후 HTTP 2xx 응답 본문에 EZSENDER_RECEIPT_V1:<eventUUID>:<sha256(raw request body)> 반환 필요. 해시는 가공 전 UTF-8 요청 본문의 SHA-256 소문자 16진수. 압축하지 않은 64KiB 이내 일반 텍스트 및 Google HtmlService HTML 응답 지원. 확인값 누락·불일치는 HTTP 200이어도 실패","default":"http_status"}},"required":["url","events"]}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"webhook":{"id":"f8d33342-aeaa-4dc2-b7e9-7e45bb44c5de","credentialId":1,"url":"https://your-service.example/ezsender/events","events":["send.completed","send.failed"],"active":true,"responseVerification":"http_status","createdAt":"2026-10-08T02:00:00.000Z","updatedAt":"2026-10-08T02:00:00.000Z"},"secret":"whsec_displayed_only_once"},"schema":{"type":"object","properties":{"webhook":{"$ref":"#/components/schemas/Webhook"},"secret":{"type":"string"}},"required":["webhook","secret"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"webhooks:write","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"수신자 알림 스탠다드 · 발송 알림 프로","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/webhooks/{id}":{"patch":{"tags":["결과 알림"],"operationId":"webhook-update","summary":"결과 알림 수정","description":"웹훅 주소·이벤트·활성 상태·전달 성공 확인 방식을 변경합니다. 생략한 설정은 유지됩니다.\n운영 제공: 수신자 알림 스탠다드 · 발송 알림 프로 · 중지 모든 요금제. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"responseVerification":"receipt_v1"},"schema":{"type":"object","properties":{"active":{"type":"boolean"},"url":{"type":"string","format":"uri"},"events":{"type":"array","items":{"type":"string","enum":["send.completed","send.failed","subscriber.created","subscriber.updated","subscriber.unsubscribed","subscriber.resubscribed","subscriber.deleted"]},"minItems":1,"uniqueItems":true},"responseVerification":{"type":"string","enum":["http_status","receipt_v1"],"description":"http_status: HTTP 2xx로 성공 확인. receipt_v1: 저장 완료 후 HTTP 2xx 응답 본문에 EZSENDER_RECEIPT_V1:<eventUUID>:<sha256(raw request body)> 반환 필요. 해시는 가공 전 UTF-8 요청 본문의 SHA-256 소문자 16진수. 압축하지 않은 64KiB 이내 일반 텍스트 및 Google HtmlService HTML 응답 지원. 확인값 누락·불일치는 HTTP 200이어도 실패"}},"minProperties":1,"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"webhook":{"id":"f8d33342-aeaa-4dc2-b7e9-7e45bb44c5de","credentialId":1,"url":"https://your-service.example/ezsender/events","events":["send.completed","send.failed"],"active":true,"responseVerification":"receipt_v1","createdAt":"2026-10-08T02:00:00.000Z","updatedAt":"2026-10-08T02:00:00.000Z"}},"schema":{"type":"object","properties":{"webhook":{"$ref":"#/components/schemas/Webhook"}},"required":["webhook"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"webhooks:write","x-additional-required-scopes":[],"x-required-live-plan":"free","x-live-plan-description":"수신자 알림 스탠다드 · 발송 알림 프로 · 중지 모든 요금제","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["결과 알림"],"operationId":"webhook-delete","summary":"결과 알림 삭제","description":"접근 가능한 계정 웹훅을 삭제합니다.\n운영 제공: 모든 요금제. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{},"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true},"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"webhooks:write","x-additional-required-scopes":[],"x-required-live-plan":"free","x-live-plan-description":"모든 요금제","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/webhooks/{id}/deliveries":{"get":{"tags":["결과 알림"],"operationId":"webhook-deliveries","summary":"결과 알림 전달 기록","description":"전달 결과와 재시도 상태를 조회합니다.\n운영 제공: 모든 요금제. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2147483647,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"deliveries":[],"pagination":{"page":1,"limit":20,"total":0,"totalPages":0}},"schema":{"type":"object","properties":{"deliveries":{"type":"array","items":{"$ref":"#/components/schemas/WebhookDelivery"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["deliveries","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"webhooks:read","x-additional-required-scopes":[],"x-required-live-plan":"free","x-live-plan-description":"모든 요금제","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/messages":{"post":{"tags":["단건 알림"],"operationId":"sendMessage","summary":"단건 알림 발송","description":"상담·접수 알림을 수신자 한 명에게 보냅니다. 수신자, 발신자, 완성된 제목과 HTML을 한 번에 전달하며 캠페인 생성이나 주소록 등록이 필요하지 않습니다.\n\n서버에서 API 키를 보관하고 호출하세요. messages:send 권한과 프로 이상 요금제가 필요합니다. 기존 키에 이 권한이 자동 추가되지는 않습니다.\n\nIdempotency-Key는 신청번호처럼 알림마다 고유한 값을 사용합니다. 네트워크 오류·시간 초과로 응답을 못 받았을 때 같은 키와 같은 내용으로 재요청하면 같은 알림을 반환합니다. 같은 키의 내용이 다르면 409입니다.\n\n202는 발송 대기열 접수입니다. message.id를 보관하고 GET /messages/{id}로 결과를 확인하세요. accepted는 SMTP 서버 접수이며 받은편지함 도착이나 열람 완료가 아닙니다.\n\nunknown은 전송 결과를 확정할 수 없는 상태입니다. 중복 발송을 막기 위해 새 요청 키로 자동 재발송하지 말고 상태를 확인하세요.\n\nHTML은 신청값을 안전하게 이스케이프하여 완성한 뒤 전달하세요. 개인화 변수 치환·광고 푸터·열람 및 클릭 추적은 추가하지 않으며 보안 정제는 유지합니다. 수신자는 한 명이며 CC·BCC·첨부파일은 지원하지 않습니다.\n\n기존 발신 주소 사용 권한, 수신거부·영구반송 보호, 계정 발송 한도를 적용합니다. 등록된 수신자의 정보나 상태를 변경하지 않습니다.\n\n503 Errors.Messages.Unavailable은 운영 발송 기능이 아직 활성화되지 않은 상태입니다. 발송 서버 반영과 운영 설정을 확인한 뒤 같은 요청 키로 다시 요청하세요. 테스트 환경은 이 설정과 무관하게 모의 실행할 수 있습니다.\n\n테스트 키는 sender@example.test 발신 주소로 모의 대기열과 상태만 반환하며 실제 이메일 발송이나 운영 데이터 변경이 없습니다. 운영 키로 실행하면 실제 알림 발송을 요청합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}},{"name":"Idempotency-Key","in":"header","required":true,"description":"같은 요청을 재시도할 때 같은 값을 유지합니다. 다른 요청에 재사용하면 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"to":{"email":"manager@example.test","name":"상담 담당자"},"from":{"email":"sender@example.test","name":"회사명"},"subject":"[상담문의] 홍길동 / 상담분야 - 기업 세무 컨설팅","html":"<h1>새 상담 문의</h1><p>신청자: 홍길동</p><p>상담 분야: 기업 세무 컨설팅</p><p>상담 내용: 상담 가능한 시간을 알려 주세요.</p>"},"schema":{"type":"object","required":["to","from","subject","html"],"additionalProperties":false,"properties":{"to":{"type":"object","required":["email"],"additionalProperties":false,"properties":{"email":{"type":"string","format":"email","maxLength":254},"name":{"type":"string","maxLength":100}}},"from":{"type":"object","required":["email","name"],"additionalProperties":false,"properties":{"email":{"type":"string","format":"email","maxLength":254},"name":{"type":"string","maxLength":100,"minLength":1}}},"subject":{"type":"string","minLength":1,"maxLength":255},"html":{"type":"string","minLength":1,"description":"UTF-8 기준 2 MiB 이하의 완성된 HTML입니다. 보안 정제가 적용됩니다. {{변수명}} 치환은 수행하지 않습니다."},"replyTo":{"anyOf":[{"type":"string","format":"email","maxLength":254},{"type":"string","const":""},{"type":"null"}],"description":"답장을 받을 이메일 주소. 생략·null·빈 문자열이면 별도 답장 주소를 지정하지 않습니다."}}}}}},"responses":{"202":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"message":{"id":"aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee","status":"queued","to":{"email":"manager@example.test","name":"상담 담당자"},"subject":"[상담문의] 홍길동 / 상담분야 - 기업 세무 컨설팅","createdAt":"2026-10-14T03:00:00.000Z","acceptedAt":null,"error":null},"idempotentReplay":false},"schema":{"type":"object","required":["message","idempotentReplay"],"properties":{"message":{"$ref":"#/components/schemas/Message"},"idempotentReplay":{"type":"boolean"}}}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"이메일 HTML 크기 한도 초과","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"messages:send","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/messages/{id}":{"get":{"tags":["단건 알림"],"operationId":"getMessage","summary":"단건 알림 상태 조회","description":"접수 응답의 message.id로 단건 알림의 처리 상태를 조회합니다. messages:read 권한이 필요합니다.\n\nqueued → sending → accepted 또는 failed로 진행합니다. 전송 결과를 확정하지 못하면 unknown을 반환하며 자동으로 다시 발송하지 않습니다.\n\nAPI 요청 성공(HTTP 200)과 메일 처리 결과는 다릅니다. message.status를 확인하세요. accepted는 SMTP 서버 접수이며 받은편지함 도착을 보장하지 않습니다.\n\n운영·테스트 데이터는 분리됩니다. 테스트 환경의 accepted는 모의 결과이며 실제 발송 증거가 아닙니다.\n운영 제공: 모든 요금제. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"message":{"id":"aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee","status":"accepted","to":{"email":"manager@example.test","name":"상담 담당자"},"subject":"[상담문의] 홍길동 / 상담분야 - 기업 세무 컨설팅","createdAt":"2026-10-14T03:00:00.000Z","acceptedAt":"2026-10-14T03:00:02.000Z","error":null}},"schema":{"type":"object","required":["message"],"properties":{"message":{"$ref":"#/components/schemas/Message"}}}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"messages:read","x-additional-required-scopes":[],"x-required-live-plan":"free","x-live-plan-description":"모든 요금제","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/address-books/segments":{"get":{"tags":["세그먼트"],"operationId":"segment-list","summary":"세그먼트 목록","description":"계정에 저장된 조건 그룹을 조회합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100000,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"segments":[],"pagination":{"page":1,"limit":20,"total":0,"totalPages":0}},"schema":{"type":"object","properties":{"segments":{"type":"array","items":{"$ref":"#/components/schemas/Segment"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["segments","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"segments:read","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"post":{"tags":["세그먼트"],"operationId":"segment-create","summary":"세그먼트 만들기","description":"수신자 조건을 저장해 캠페인의 수신 대상으로 사용할 수 있습니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"뉴스레터 수신자","conditions":[{"id":"group-1","conditions":[{"id":"condition-1-1","field":"email","operator":"contains","value":"@example.test"}]}]},"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":2000},"conditions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"conditions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"field":{"type":"string","enum":["email","name","phone","memo","source","custom_field","group","email_status","created_at","unsubscribed_at"]},"operator":{"type":"string","enum":["equals","not_equals","contains","not_contains","starts_with","ends_with","is_empty","is_not_empty","belongs_to","not_belongs_to","before","after","on","between"]},"value":{"type":"string","maxLength":1000},"customStorageKey":{"type":"string","maxLength":100}},"required":["field","operator"],"additionalProperties":false},"minItems":1,"maxItems":100}},"required":["conditions"]},"minItems":1,"maxItems":20}},"required":["name","conditions"],"additionalProperties":false}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"segment":{"id":1,"name":"뉴스레터 수신자","description":"","conditions":[{"id":"group-1","conditions":[{"id":"condition-1-1","field":"email","operator":"contains","value":"@example.test"}]}],"createdAt":"2026-10-08T02:00:00.000Z","updatedAt":"2026-10-08T02:00:00.000Z"}},"schema":{"type":"object","properties":{"segment":{"$ref":"#/components/schemas/Segment"}},"required":["segment"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"segments:write","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/address-books/segments/{id}":{"get":{"tags":["세그먼트"],"operationId":"segment-detail","summary":"세그먼트 조회","description":"저장한 세그먼트의 조건을 조회합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"segment":{"id":1,"name":"뉴스레터 수신자","description":"","conditions":[{"id":"group-1","conditions":[{"id":"condition-1-1","field":"email","operator":"contains","value":"@example.test"}]}],"createdAt":"2026-10-08T02:00:00.000Z","updatedAt":"2026-10-08T02:00:00.000Z"}},"schema":{"type":"object","properties":{"segment":{"$ref":"#/components/schemas/Segment"}},"required":["segment"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"segments:read","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"patch":{"tags":["세그먼트"],"operationId":"segment-update","summary":"세그먼트 수정","description":"이름·설명·조건을 수정합니다. 생략한 항목은 유지합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"관심 고객"},"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":2000},"conditions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"conditions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"field":{"type":"string","enum":["email","name","phone","memo","source","custom_field","group","email_status","created_at","unsubscribed_at"]},"operator":{"type":"string","enum":["equals","not_equals","contains","not_contains","starts_with","ends_with","is_empty","is_not_empty","belongs_to","not_belongs_to","before","after","on","between"]},"value":{"type":"string","maxLength":1000},"customStorageKey":{"type":"string","maxLength":100}},"required":["field","operator"],"additionalProperties":false},"minItems":1,"maxItems":100}},"required":["conditions"]},"minItems":1,"maxItems":20}},"required":[],"minProperties":1,"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"segment":{"id":1,"name":"관심 고객","description":"","conditions":[{"id":"group-1","conditions":[{"id":"condition-1-1","field":"email","operator":"contains","value":"@example.test"}]}],"createdAt":"2026-10-08T02:00:00.000Z","updatedAt":"2026-10-08T02:00:00.000Z"}},"schema":{"type":"object","properties":{"segment":{"$ref":"#/components/schemas/Segment"}},"required":["segment"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"segments:write","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["세그먼트"],"operationId":"segment-delete","summary":"세그먼트 삭제","description":"조건 정의를 삭제합니다. 주소록 수신자는 삭제되지 않습니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"deletedId":1},"schema":{"type":"object","properties":{"success":{"const":true},"deletedId":{"type":"integer","minimum":1,"maximum":2147483647}},"required":["success","deletedId"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"segments:write","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/address-books/segments/{id}/subscribers":{"get":{"tags":["세그먼트"],"operationId":"segment-recipients","summary":"세그먼트 발송 대상 조회","description":"조건에 맞는 현재 발송 가능 수신자를 이메일별로 중복 제거해 조회합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100000,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"subscribers":[],"pagination":{"page":1,"limit":100,"total":0,"totalPages":0}},"schema":{"type":"object","properties":{"subscribers":{"type":"array","items":{"$ref":"#/components/schemas/Subscriber"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["subscribers","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"segments:read","x-additional-required-scopes":["subscribers:read"],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/address-books/custom-fields":{"get":{"tags":["필드(정보항목)"],"operationId":"custom-field-list","summary":"필드(정보항목) 목록","description":"이름·이메일 기본 항목과 계정에 등록한 추가 필드(정보항목), 요금제의 추가 항목 한도를 조회합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"fields":[{"id":11,"name":"이름","type":"text","code":"{{이름}}","defaultValue":null,"displayOrder":0,"isDefault":true,"isGlobal":true},{"id":12,"name":"이메일","type":"text","code":"{{이메일}}","defaultValue":null,"displayOrder":1,"isDefault":true,"isGlobal":true},{"id":1,"name":"고객 등급","type":"text","code":"{{grade}}","defaultValue":null,"displayOrder":1,"isDefault":false,"isGlobal":false}],"maxCustomFields":100},"schema":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/CustomField"}},"maxCustomFields":{"type":"integer","minimum":0,"description":"추가 필드(정보항목) 개수 한도. 스타터는 5개, 스탠다드·프로·엔터프라이즈는 100개입니다."}},"required":["fields","maxCustomFields"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"custom_fields:read","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"post":{"tags":["필드(정보항목)"],"operationId":"custom-field-create","summary":"필드(정보항목) 만들기","description":"수신자 프로필과 개인화에 사용할 추가 필드(정보항목)를 등록합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"고객 등급","code":"{{grade}}","type":"text"},"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"type":{"type":"string","enum":["text","number","date","datetime","dropdown","link"],"default":"text"},"code":{"type":"string","pattern":"^\\{\\{(?!\\s)[^{}\\u0000-\\u001F\\u007F-\\u009F]+(?<!\\s)\\}\\}$","maxLength":100},"defaultValue":{"type":["string","null"],"maxLength":1000}},"required":["name"],"additionalProperties":false}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"field":{"id":1,"name":"고객 등급","type":"text","code":"{{grade}}","defaultValue":null,"displayOrder":1,"isDefault":false,"isGlobal":false}},"schema":{"type":"object","properties":{"field":{"$ref":"#/components/schemas/CustomField"}},"required":["field"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"custom_fields:write","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/address-books/custom-fields/{id}":{"patch":{"tags":["필드(정보항목)"],"operationId":"custom-field-update","summary":"필드(정보항목) 수정","description":"추가 필드(정보항목)의 이름, 삽입 코드, 형식, 기본값을 변경합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"멤버십 등급","code":"{{membership}}"},"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"type":{"type":"string","enum":["text","number","date","datetime","dropdown","link"],"default":"text"},"code":{"type":"string","pattern":"^\\{\\{(?!\\s)[^{}\\u0000-\\u001F\\u007F-\\u009F]+(?<!\\s)\\}\\}$","maxLength":100},"defaultValue":{"type":["string","null"],"maxLength":1000}},"required":[],"minProperties":1,"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"field":{"id":1,"name":"멤버십 등급","type":"text","code":"{{membership}}","defaultValue":null,"displayOrder":1,"isDefault":false,"isGlobal":false}},"schema":{"type":"object","properties":{"field":{"$ref":"#/components/schemas/CustomField"}},"required":["field"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"custom_fields:write","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["필드(정보항목)"],"operationId":"custom-field-delete","summary":"필드(정보항목) 삭제","description":"사용자 필드(정보항목) 정의를 삭제합니다. 기본 항목은 삭제할 수 없습니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"deletedId":1},"schema":{"type":"object","properties":{"success":{"const":true},"deletedId":{"type":"integer","minimum":1,"maximum":2147483647}},"required":["success","deletedId"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"custom_fields:write","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/subscribers/{id}":{"get":{"tags":["수신자"],"operationId":"subscriber-detail","summary":"수신자 프로필 조회","description":"ID가 가리키는 한 그룹 소속의 프로필을 조회합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"subscriber":{"id":1,"email":"sample@example.test","name":"테스트 수신자","status":"active","marketingAllowed":null,"groupId":1,"groups":["테스트 그룹"]}},"schema":{"type":"object","properties":{"subscriber":{"$ref":"#/components/schemas/Subscriber"}},"required":["subscriber"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"subscribers:read","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"patch":{"tags":["수신자"],"operationId":"subscriber-profile-update","summary":"수신자 프로필 수정","description":"특정 그룹 소속의 프로필만 수정합니다. 이메일·수신 상태·그룹은 전용 API로 관리합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"홍길동"},"schema":{"type":"object","properties":{"name":{"type":"string"},"phone":{"type":"string"},"memo":{"type":"string","maxLength":10000},"source":{"type":"string","maxLength":100},"marketingAllowed":{"type":"boolean","description":"광고 동의 기록. 수신 상태·재구독 동의나 발송 제한을 변경하지 않습니다."},"customFields":{"type":"object","maxProperties":100,"additionalProperties":{"type":"string"}}},"required":[],"minProperties":1,"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"subscriber":{"id":1,"email":"sample@example.test","name":"홍길동","status":"active","marketingAllowed":null,"groupId":1,"groups":["테스트 그룹"]}},"schema":{"type":"object","properties":{"subscriber":{"$ref":"#/components/schemas/Subscriber"}},"required":["subscriber"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"subscribers:write","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/subscribers/{id}/groups":{"post":{"tags":["수신자"],"operationId":"subscriber-group-add","summary":"수신자 그룹 추가","description":"같은 이메일을 선택한 그룹에 추가하며 기존 소속은 그대로 유지합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"groupIds":[1]},"schema":{"type":"object","properties":{"groupIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"minItems":1,"maxItems":100,"uniqueItems":true}},"required":["groupIds"],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"changed":0,"memberships":[{"subscriberId":1,"groupId":1,"groupName":"테스트 그룹"}]},"schema":{"type":"object","properties":{"success":{"const":true},"changed":{"type":"integer","minimum":0},"memberships":{"type":"array","items":{"type":"object","properties":{"subscriberId":{"type":"integer","minimum":1,"maximum":2147483647},"groupId":{"type":"integer","minimum":1,"maximum":2147483647},"groupName":{"type":"string"}},"required":["subscriberId","groupId","groupName"]}}},"required":["success","changed","memberships"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"subscribers:write","x-additional-required-scopes":["address_books:write"],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["수신자"],"operationId":"subscriber-group-remove","summary":"수신자 그룹 제거","description":"같은 이메일의 선택한 그룹 소속을 제거합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"groupIds":[2]},"schema":{"type":"object","properties":{"groupIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"minItems":1,"maxItems":100,"uniqueItems":true}},"required":["groupIds"],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"changed":1,"memberships":[{"subscriberId":1,"groupId":1,"groupName":"테스트 그룹"}]},"schema":{"type":"object","properties":{"success":{"const":true},"changed":{"type":"integer","minimum":0},"memberships":{"type":"array","items":{"type":"object","properties":{"subscriberId":{"type":"integer","minimum":1,"maximum":2147483647},"groupId":{"type":"integer","minimum":1,"maximum":2147483647},"groupName":{"type":"string"}},"required":["subscriberId","groupId","groupName"]}}},"required":["success","changed","memberships"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"subscribers:write","x-additional-required-scopes":["address_books:write"],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/subscribers/unsubscribed":{"get":{"tags":["수신자"],"operationId":"unsubscribed-list","summary":"수신거부 수신자 목록","description":"현재 주소록의 수신거부 수신자를 이메일별로 조회합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100000,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"groupId","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"subscribers":[],"pagination":{"page":1,"limit":100,"total":0,"totalPages":0}},"schema":{"type":"object","properties":{"subscribers":{"type":"array","items":{"$ref":"#/components/schemas/Subscriber"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["subscribers","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"subscribers:read","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/subscribers/hard-bounces":{"get":{"tags":["수신자"],"operationId":"hard-bounce-list","summary":"확인된 영구반송 목록","description":"명시적 영구반송 근거와 최신 이력이 일치하는 주소를 조회합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100000,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"items":[],"pagination":{"page":1,"limit":25,"total":0,"totalPages":0}},"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/HardBounce"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["items","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"subscribers:read","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/subscribers/{id}/activities":{"get":{"tags":["수신자"],"operationId":"activity-list","summary":"수신자 활동 기록","description":"소유한 수신자의 발송 결과·최초 열람·클릭·구독취소 기록을 조회합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100000,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","enum":[5,25,50],"default":25}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["all","email_sent","email_failed","email_bounced","email_opened","email_clicked","email_unsubscribed"],"default":"all"}},{"name":"search","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"activities":[],"pagination":{"page":1,"limit":25,"total":0,"totalPages":0}},"schema":{"type":"object","properties":{"activities":{"type":"array","items":{"$ref":"#/components/schemas/SubscriberActivity"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["activities","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"subscribers:read","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/automations/{id}/activate":{"post":{"tags":["자동화"],"operationId":"automation-activate","summary":"자동화 활성화","description":"발신 주소·작성 내용·조건·계정 권한과 실행 기능을 검증한 뒤 신규 진입을 허용합니다.\n운영 제공: 기본 자동화 스탠다드 · 고급 자동화 프로. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"activationPeriod":{"noEnd":true}},"schema":{"type":"object","properties":{"activationPeriod":{"type":"object","properties":{"from":{"type":["string","null"],"format":"date"},"to":{"type":["string","null"],"format":"date"},"noEnd":{"type":"boolean"}},"required":[]}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"automation":{"id":10,"name":"가입 환영 메일","status":"active","triggerType":"manual","steps":[]}},"schema":{"type":"object","properties":{"automation":{"$ref":"#/components/schemas/Automation"}},"required":["automation"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"automations:send","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"기본 자동화 스탠다드 · 고급 자동화 프로","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/automations/{id}/pause":{"post":{"tags":["자동화"],"operationId":"automation-pause","summary":"자동화 일시정지","description":"신규 진입만 멈추거나 기존 대상의 단계 진행과 대기 발송까지 함께 멈춥니다. 기존 실행과 대기열은 보존합니다.\n운영 제공: 모든 요금제. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"pauseMode":"entry_only"},"schema":{"type":"object","properties":{"pauseMode":{"type":"string","enum":["entry_only","all"]}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"automation":{"id":10,"name":"가입 환영 메일","status":"paused","triggerType":"manual","steps":[],"pauseMode":"entry_only"}},"schema":{"type":"object","properties":{"automation":{"$ref":"#/components/schemas/Automation"}},"required":["automation"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"automations:send","x-additional-required-scopes":[],"x-required-live-plan":"free","x-live-plan-description":"모든 요금제","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/automations/{id}/end":{"post":{"tags":["자동화"],"operationId":"automation-end","summary":"자동화 종료","description":"새로운 진입과 진행 중 실행을 종료합니다. 종료된 자동화는 재개할 수 없습니다.\n운영 제공: 모든 요금제. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{},"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"automation":{"id":10,"name":"가입 환영 메일","status":"ended","triggerType":"manual","steps":[]}},"schema":{"type":"object","properties":{"automation":{"$ref":"#/components/schemas/Automation"}},"required":["automation"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"automations:send","x-additional-required-scopes":[],"x-required-live-plan":"free","x-live-plan-description":"모든 요금제","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/automations/{id}/stats":{"get":{"tags":["자동화"],"operationId":"automation-stats","summary":"자동화 실행 통계","description":"대상자 진입·현재 진행·대기·완료·이탈과 이메일 단계 성과를 공통 통계 기준으로 조회합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"automationId":10,"from":null,"to":null,"flow":{"summary":{}},"emailSteps":[]},"schema":{"type":"object","properties":{"automationId":{"type":"integer"},"from":{"type":["string","null"]},"to":{"type":["string","null"]},"flow":{"type":"object","properties":{"summary":{"type":"object","additionalProperties":true},"steps":{"type":"array","items":{"type":"object","additionalProperties":true}},"asOf":{"type":"string"}},"required":[]},"emailSteps":{"type":"array","items":{"type":"object","properties":{"stepId":{"type":["string","null"]},"sent":{"type":"integer","minimum":0},"delivered":{"type":"integer","minimum":0},"opened":{"type":["integer","null"]},"clicked":{"type":["integer","null"]},"failed":{"type":"integer","minimum":0},"unsubscribed":{"type":"integer","minimum":0}},"required":[]}}},"required":[]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"automations:read","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"reports","limit":100,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/automations/{id}/recipients":{"get":{"tags":["자동화"],"operationId":"automation-recipients","summary":"자동화 대상자 조회","description":"실행 요약·단계·성과·분기별 대상자를 조회합니다. subscribers:read 권한이 추가로 필요합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"scope","in":"query","required":false,"schema":{"type":"string","enum":["summary","step","metric","path"],"default":"summary"}},{"name":"key","in":"query","required":false,"schema":{"type":"string"}},{"name":"stepId","in":"query","required":false,"schema":{"type":"string"}},{"name":"toStepId","in":"query","required":false,"schema":{"type":"string"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"search","in":"query","required":false,"schema":{"type":"string","maxLength":300}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["all","completed","activity","attention"]}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"snapshot","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"items":[],"total":0,"scopeTotal":0,"page":1,"pageSize":20,"totalPages":0,"snapshot":"2026-10-08T03:00:00Z"},"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"stopId":{"type":"string"},"name":{"type":"string"},"email":{"type":"string","format":"email"},"statusLabel":{"type":"string"},"statusTone":{"type":"string"},"timestamp":{"type":"string"},"detail":{"type":"string"},"currentStep":{"type":"string"}},"required":[]}},"total":{"type":"integer","minimum":0},"scopeTotal":{"type":"integer","minimum":0},"page":{"type":"integer","minimum":1},"pageSize":{"type":"integer","minimum":1,"maximum":50},"totalPages":{"type":"integer","minimum":0},"lastActivity":{"type":["string","null"]},"snapshot":{"type":"string","format":"date-time"}},"required":["items","total","scopeTotal","page","pageSize","totalPages","snapshot"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"automations:read","x-additional-required-scopes":["subscribers:read"],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"reports","limit":100,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/automations/{id}/recipients/stop":{"post":{"tags":["자동화"],"operationId":"automation-recipients-stop","summary":"선택한 자동화 대상 중단","description":"중단 범위를 먼저 확인하고 같은 대상과 확인 토큰으로 재검증하여 중단합니다.\n운영 제공: 모든 요금제. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"action":"preview","key":"current","selectedIds":["flow-0123456789abcdef0123456789abcdef"]},"schema":{"type":"object","properties":{"action":{"type":"string","enum":["preview","confirm"]},"key":{"type":"string","enum":["active","current","waiting"]},"from":{"type":["string","null"],"format":"date"},"to":{"type":["string","null"],"format":"date"},"selectedIds":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":100000},"confirmationToken":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["action","key","selectedIds"],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"peopleCount":1,"executionCount":1,"pendingMailCount":1,"handedOffMailCount":0,"confirmationToken":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"},"schema":{"oneOf":[{"type":"object","properties":{"peopleCount":{"type":"integer","minimum":0},"executionCount":{"type":"integer","minimum":0},"pendingMailCount":{"type":"integer","minimum":0},"handedOffMailCount":{"type":"integer","minimum":0},"confirmationToken":{"type":"string"}},"required":[]},{"type":"object","properties":{"stoppedPeople":{"type":"integer","minimum":0},"stoppedExecutions":{"type":"integer","minimum":0},"cancelledMailCount":{"type":"integer","minimum":0},"handedOffMailCount":{"type":"integer","minimum":0}},"required":[]}]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"automations:send","x-additional-required-scopes":["subscribers:read"],"x-required-live-plan":"free","x-live-plan-description":"모든 요금제","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/account":{"get":{"tags":["계정·발신 정보"],"operationId":"account-detail","summary":"계정과 사용량 조회","description":"현재 요금제, 운영 API의 기능별 제공 범위·호출 한도와 수신자·월간 발송 등록량을 조회합니다. 요금제나 계정 설정을 변경하지 않습니다.\n운영 제공: 모든 요금제. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"account":{"id":1,"plan":{"code":"pro","name":"프로","expiresAt":null,"expired":false},"limits":{"subscribers":10000,"monthlyRecipients":100000,"recipientsPerSend":null,"monthlyCampaigns":null},"api":{"effectivePlan":"pro","testEnvironmentAvailable":true,"requestRetentionDays":30,"operations":[{"operationId":"getMessage","requiredPlan":"free","planRequirement":"모든 요금제","planAllowed":true},{"operationId":"auth-check","requiredPlan":"free","planRequirement":"모든 요금제","planAllowed":true},{"operationId":"account-detail","requiredPlan":"free","planRequirement":"모든 요금제","planAllowed":true},{"operationId":"send-job-list","requiredPlan":"free","planRequirement":"모든 요금제","planAllowed":true},{"operationId":"send-job-detail","requiredPlan":"free","planRequirement":"모든 요금제","planAllowed":true},{"operationId":"send-job-cancel","requiredPlan":"free","planRequirement":"모든 요금제","planAllowed":true},{"operationId":"webhook-list","requiredPlan":"free","planRequirement":"모든 요금제","planAllowed":true},{"operationId":"webhook-update","requiredPlan":"free","planRequirement":"수신자 알림 스탠다드 · 발송 알림 프로 · 중지 모든 요금제","planAllowed":true},{"operationId":"webhook-delete","requiredPlan":"free","planRequirement":"모든 요금제","planAllowed":true},{"operationId":"webhook-deliveries","requiredPlan":"free","planRequirement":"모든 요금제","planAllowed":true},{"operationId":"automation-pause","requiredPlan":"free","planRequirement":"모든 요금제","planAllowed":true},{"operationId":"automation-end","requiredPlan":"free","planRequirement":"모든 요금제","planAllowed":true},{"operationId":"automation-recipients-stop","requiredPlan":"free","planRequirement":"모든 요금제","planAllowed":true},{"operationId":"sender-list","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"sender-domain-list","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"subscriber-count","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"subscriber-campaign-stats","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"subscriber-double-opt-in","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"subscriber-list","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"subscriber-add","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"subscriber-status","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"subscriber-delete","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"subscriber-detail","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"subscriber-profile-update","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"subscriber-group-add","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"subscriber-group-remove","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"group-members-add","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"group-members-remove","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"unsubscribed-list","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"hard-bounce-list","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"activity-list","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"segment-list","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"segment-detail","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"segment-recipients","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"segment-create","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"segment-update","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"segment-delete","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"custom-field-list","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"custom-field-create","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"custom-field-update","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"custom-field-delete","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"automation-list","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"automation-detail","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"automation-email-add","requiredPlan":"standard","planRequirement":"기본 자동화 스탠다드 · 고급 자동화 프로","planAllowed":true},{"operationId":"automation-run","requiredPlan":"standard","planRequirement":"기본 자동화 스탠다드 · 고급 자동화 프로","planAllowed":true},{"operationId":"automation-create","requiredPlan":"standard","planRequirement":"기본 자동화 스탠다드 · 고급 자동화 프로","planAllowed":true},{"operationId":"automation-update","requiredPlan":"standard","planRequirement":"기본 자동화 스탠다드 · 고급 자동화 프로","planAllowed":true},{"operationId":"automation-delete","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"automation-activate","requiredPlan":"standard","planRequirement":"기본 자동화 스탠다드 · 고급 자동화 프로","planAllowed":true},{"operationId":"automation-stats","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"automation-recipients","requiredPlan":"standard","planRequirement":"스탠다드 이상","planAllowed":true},{"operationId":"webhook-create","requiredPlan":"standard","planRequirement":"수신자 알림 스탠다드 · 발송 알림 프로","planAllowed":true},{"operationId":"sendMessage","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"attachment-list","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"attachment-detail","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"attachment-upload","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"attachment-delete","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"template-list","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"template-detail","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"template-create","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"template-update","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"template-delete","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"template-campaign-create","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-list","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-detail","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-create","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-update","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-copy","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-delete","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-ab-detail","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-ab-update","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-ab-stats","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-test-send","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-send-job-create","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"send-job-reschedule","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-tag-list","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-tag-add","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-tag-remove","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-report","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-report-batch","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-report-links","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-report-recipients","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"campaign-report-click-events","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"group-list","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"group-create","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"group-update","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"group-delete","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"newsletter-page-get","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"newsletter-page-availability","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"newsletter-issue-list","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"newsletter-issue-detail","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"newsletter-page-create","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"newsletter-page-update","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"newsletter-issue-create","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"newsletter-issue-update","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"newsletter-issue-delete","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"newsletter-issue-publish","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-list","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-detail","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-source-list","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-audience","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-segment-list","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-mail-options","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-mail-report","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-create","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-update","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-delete-preview","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-delete","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-publish","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-copy","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-source-create","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-segment-create","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-contact-sync-update","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-contact-sync-disable","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-entry-list","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-entry-detail","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-entry-retry","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"form-entry-cancel","requiredPlan":"pro","planRequirement":"프로 이상","planAllowed":true},{"operationId":"address-book-list","requiredPlan":"enterprise","planRequirement":"엔터프라이즈 이상","planAllowed":false},{"operationId":"address-book-detail","requiredPlan":"enterprise","planRequirement":"엔터프라이즈 이상","planAllowed":false},{"operationId":"address-book-create","requiredPlan":"enterprise","planRequirement":"엔터프라이즈 이상","planAllowed":false},{"operationId":"address-book-update","requiredPlan":"enterprise","planRequirement":"엔터프라이즈 이상","planAllowed":false},{"operationId":"address-book-copy","requiredPlan":"enterprise","planRequirement":"엔터프라이즈 이상","planAllowed":false},{"operationId":"address-book-delete","requiredPlan":"enterprise","planRequirement":"엔터프라이즈 이상","planAllowed":false},{"operationId":"address-book-groups","requiredPlan":"enterprise","planRequirement":"엔터프라이즈 이상","planAllowed":false},{"operationId":"sender-identity-list","requiredPlan":"enterprise","planRequirement":"엔터프라이즈 이상","planAllowed":false},{"operationId":"sender-identity-detail","requiredPlan":"enterprise","planRequirement":"엔터프라이즈 이상","planAllowed":false},{"operationId":"sender-identity-create","requiredPlan":"enterprise","planRequirement":"엔터프라이즈 이상","planAllowed":false},{"operationId":"sender-identity-delete","requiredPlan":"enterprise","planRequirement":"엔터프라이즈 이상","planAllowed":false},{"operationId":"sender-identity-verification","requiredPlan":"enterprise","planRequirement":"엔터프라이즈 이상","planAllowed":false}],"rateLimits":[{"bucket":"subscriber-import","limit":10,"windowSeconds":60},{"bucket":"reports","limit":100,"windowSeconds":60},{"bucket":"general","limit":1000,"windowSeconds":60},{"bucket":"automation-run","limit":3,"windowSeconds":1}]},"usage":{"month":"2026-10","subscribers":1250,"recipientReservations":2500,"campaignReservations":2}}},"schema":{"type":"object","properties":{"account":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"plan":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"expiresAt":{"type":["string","null"],"format":"date"},"expired":{"type":"boolean"}},"required":["code","name","expiresAt","expired"]},"limits":{"type":"object","properties":{"subscribers":{"type":["integer","null"]},"monthlyRecipients":{"type":["integer","null"]},"recipientsPerSend":{"type":["integer","null"]},"monthlyCampaigns":{"type":["integer","null"]}},"required":["subscribers","monthlyRecipients","recipientsPerSend","monthlyCampaigns"]},"api":{"type":"object","properties":{"effectivePlan":{"type":"string","enum":["free","standard","pro","enterprise"]},"testEnvironmentAvailable":{"const":true},"requestRetentionDays":{"type":"integer","minimum":0},"operations":{"type":"array","items":{"type":"object","properties":{"operationId":{"type":"string"},"requiredPlan":{"type":"string","enum":["free","standard","pro","enterprise"]},"planRequirement":{"type":"string","description":"고급 자동화·웹훅 이벤트처럼 요청 내용에 따라 달라지는 제공 조건을 포함합니다."},"planAllowed":{"type":"boolean","description":"기본 요금제 조건 충족 여부입니다. 키·사용자 권한, 고급 자동화와 웹훅 이벤트별 조건은 별도로 확인합니다."}},"required":["operationId","requiredPlan","planRequirement","planAllowed"]}},"rateLimits":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":2147483647},"windowSeconds":{"type":"integer","minimum":1,"maximum":2147483647}},"required":["bucket","limit","windowSeconds"]}}},"required":["effectivePlan","testEnvironmentAvailable","requestRetentionDays","operations","rateLimits"]},"usage":{"type":"object","properties":{"month":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"subscribers":{"type":"integer","minimum":0},"recipientReservations":{"type":"integer","minimum":0},"campaignReservations":{"type":"integer","minimum":0}},"required":["month","subscribers","recipientReservations","campaignReservations"]}},"required":["id","plan","limits","api","usage"]}},"required":["account"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"account:read","x-additional-required-scopes":[],"x-required-live-plan":"free","x-live-plan-description":"모든 요금제","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/senders":{"get":{"tags":["계정·발신 정보"],"operationId":"sender-list","summary":"사용 가능한 발신 주소 조회","description":"인증한 발신 주소와 계정이 보유한 기본 제공 주소, 우선 선택될 발신 정보를 조회합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"defaultSender":{"name":"테스트 발신자","email":"sender@example.test"},"senders":[{"email":"sender@example.test","domain":"example.test","source":"verified","isDefault":true}]},"schema":{"type":"object","properties":{"defaultSender":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":["string","null"]}},"required":["name","email"]},"senders":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string","format":"email"},"domain":{"type":"string"},"source":{"type":"string","enum":["shared","verified"]},"isDefault":{"type":"boolean"}},"required":["email","domain","source","isDefault"]}}},"required":["defaultSender","senders"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"senders:read","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/sender-domains":{"get":{"tags":["계정·발신 정보"],"operationId":"sender-domain-list","summary":"발신 도메인 인증 상태 조회","description":"등록된 도메인의 최근 SPF·DKIM·DMARC 확인 결과를 조회합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"domains":[{"domain":"example.test","verifiedSenderCount":1,"spf":{"verified":true,"checkedAt":"2026-10-08T00:00:00.000Z"},"dkim":{"verified":true,"checkedAt":"2026-10-08T00:00:00.000Z"},"dmarc":{"verified":true,"checkedAt":"2026-10-08T00:00:00.000Z"}}]},"schema":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"verifiedSenderCount":{"type":"integer","minimum":0},"spf":{"type":"object","properties":{"verified":{"type":"boolean"},"checkedAt":{"type":["string","null"],"format":"date-time"}},"required":["verified","checkedAt"]},"dkim":{"type":"object","properties":{"verified":{"type":"boolean"},"checkedAt":{"type":["string","null"],"format":"date-time"}},"required":["verified","checkedAt"]},"dmarc":{"type":"object","properties":{"verified":{"type":"boolean"},"checkedAt":{"type":["string","null"],"format":"date-time"}},"required":["verified","checkedAt"]}},"required":["domain","verifiedSenderCount","spf","dkim","dmarc"]}}},"required":["domains"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"senders:read","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/templates":{"get":{"tags":["이메일 템플릿"],"operationId":"template-list","summary":"이메일 템플릿 목록","description":"사용 가능한 기본 템플릿과 내 개인 템플릿을 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["all","personal","default"],"default":"all"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"templates":[{"id":1,"name":"월간 소식 템플릿","kind":"personal","editable":true,"createdAt":"2026-10-08T00:00:00.000Z","updatedAt":"2026-10-08T00:00:00.000Z"}],"pagination":{"page":1,"limit":20,"total":1,"totalPages":1}},"schema":{"type":"object","properties":{"templates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string"},"kind":{"type":"string","enum":["default","personal"]},"editable":{"type":"boolean"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","name","kind","editable","createdAt","updatedAt"]}},"pagination":{"type":"object","properties":{"page":{"type":"integer","minimum":1,"maximum":2147483647},"limit":{"type":"integer","minimum":1,"maximum":2147483647},"total":{"type":"integer","minimum":0},"totalPages":{"type":"integer","minimum":0}},"required":["page","limit","total","totalPages"]}},"required":["templates","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"templates:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"post":{"tags":["이메일 템플릿"],"operationId":"template-create","summary":"개인 이메일 템플릿 만들기","description":"외부에서 작성한 HTML을 재사용할 개인 이메일 템플릿으로 저장합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"월간 소식 템플릿","html":"<p>월간 소식입니다.</p>"},"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"html":{"type":"string","minLength":1,"description":"5MB 이하 이메일 HTML. 저장 시 기존 이메일 보안 정제가 적용됩니다."}},"required":["name","html"],"additionalProperties":false}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"template":{"id":1,"name":"월간 소식 템플릿","kind":"personal","editable":true,"createdAt":"2026-10-08T00:00:00.000Z","updatedAt":"2026-10-08T00:00:00.000Z"}},"schema":{"type":"object","properties":{"template":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string"},"kind":{"type":"string","enum":["default","personal"]},"editable":{"type":"boolean"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","name","kind","editable","createdAt","updatedAt"]}},"required":["template"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"templates:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/templates/{id}":{"get":{"tags":["이메일 템플릿"],"operationId":"template-detail","summary":"이메일 템플릿 상세","description":"선택한 템플릿의 정보와 렌더링된 이메일 HTML을 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"template":{"id":1,"name":"월간 소식 템플릿","kind":"personal","editable":true,"createdAt":"2026-10-08T00:00:00.000Z","updatedAt":"2026-10-08T00:00:00.000Z","html":"<p>월간 소식</p>"}},"schema":{"type":"object","properties":{"template":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string"},"kind":{"type":"string","enum":["default","personal"]},"editable":{"type":"boolean"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"html":{"type":"string"}},"required":["id","name","kind","editable","createdAt","updatedAt","html"]}},"required":["template"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"templates:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"patch":{"tags":["이메일 템플릿"],"operationId":"template-update","summary":"개인 이메일 템플릿 수정","description":"개인 템플릿의 이름 또는 HTML을 바꿉니다. 생략한 필드는 유지됩니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"새 템플릿 이름"},"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"html":{"type":"string","minLength":1,"description":"5MB 이하 이메일 HTML. 저장 시 기존 이메일 보안 정제가 적용됩니다."}},"required":[],"additionalProperties":false,"anyOf":[{"required":["name"]},{"required":["html"]}]}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"template":{"id":1,"name":"새 템플릿 이름","kind":"personal","editable":true,"createdAt":"2026-10-08T00:00:00.000Z","updatedAt":"2026-10-08T00:00:00.000Z"}},"schema":{"type":"object","properties":{"template":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string"},"kind":{"type":"string","enum":["default","personal"]},"editable":{"type":"boolean"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","name","kind","editable","createdAt","updatedAt"]}},"required":["template"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"templates:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["이메일 템플릿"],"operationId":"template-delete","summary":"개인 이메일 템플릿 삭제","description":"내 개인 템플릿을 보관 목록에서 제거합니다. 이미 만든 캠페인은 유지됩니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true},"schema":{"type":"object","properties":{"success":{"const":true}},"required":["success"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"templates:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/templates/{id}/campaigns":{"post":{"tags":["이메일 템플릿"],"operationId":"template-campaign-create","summary":"템플릿으로 캠페인 초안 만들기","description":"템플릿의 저장된 내용을 복사하여 새 캠페인 초안을 만듭니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"subject":"이번 달 소식","senderName":"테스트 발신자","senderEmail":"sender@example.test"},"schema":{"type":"object","properties":{"subject":{"type":"string","minLength":1,"maxLength":255},"title":{"type":"string","minLength":1,"maxLength":255},"senderName":{"type":"string","maxLength":255},"senderEmail":{"type":"string","format":"email","maxLength":254},"previewText":{"type":"string","maxLength":1000},"campaignType":{"type":"string","enum":["newsletter","ad"],"default":"newsletter"}},"required":["subject"],"additionalProperties":false}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"campaign":{"id":10,"title":"이번 달 소식","subject":"이번 달 소식","status":"draft","html":"<p>월간 소식</p>","recipients":{"groups":[],"segments":[],"excludeGroups":[],"excludeSegments":[]}}},"schema":{"type":"object","properties":{"campaign":{"$ref":"#/components/schemas/Campaign"}},"required":["campaign"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"templates:read","x-additional-required-scopes":["campaigns:write"],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/forms":{"get":{"tags":["신청 페이지"],"operationId":"form-list","summary":"신청 페이지 목록","description":"내용을 제외한 페이지 상태·신청 수·방문 수를 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"forms":[]},"schema":{"type":"object","properties":{"forms":{"type":"array","items":{"$ref":"#/components/schemas/FormListItem"}}},"required":["forms"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"post":{"tags":["신청 페이지"],"operationId":"form-create","summary":"신청 페이지 초안 만들기","description":"목적에 맞는 기본 질문이 포함된 비공개 초안을 만듭니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"purpose":"general"},"schema":{"type":"object","properties":{"purpose":{"type":"string","enum":["general","webinar","resource","consultation","event"],"default":"general"}},"required":[]}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"form":{"id":"c47fdbfa-5b24-40ee-95b4-d81f428cc4b3","slug":"example-form","title":"새 신청 페이지","status":"draft","draft":{"purpose":"general","title":"새 신청 페이지","description":"","imageUrl":"","eventAt":null,"location":"","buttonText":"신청하기","accentColor":"#4f46e5","fields":[{"id":"email","label":"이메일","type":"email","required":true},{"id":"name","label":"이름","type":"text","required":true}],"privacyText":"","marketingEnabled":false,"marketingText":"","successTitle":"신청이 완료되었습니다","successMessage":"신청해 주셔서 감사합니다.","successLinkLabel":"","successLinkUrl":"","closesAt":null,"followUp":{"enabled":false,"sourceCampaignId":null,"timing":"immediate","scheduledAt":null,"latePolicy":"skip"}},"published":null,"revision":1,"publishedRevision":null,"createdAt":"2026-10-08T02:00:00.000Z","updatedAt":"2026-10-08T02:00:00.000Z","contactSyncEnabled":false}},"schema":{"type":"object","properties":{"form":{"$ref":"#/components/schemas/Form"}},"required":["form"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/forms/{id}":{"get":{"tags":["신청 페이지"],"operationId":"form-detail","summary":"신청 페이지 조회","description":"현재 초안·게시본·수정 버전을 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"form":{"id":"c47fdbfa-5b24-40ee-95b4-d81f428cc4b3","slug":"example-form","title":"새 신청 페이지","status":"draft","draft":{"purpose":"general","title":"새 신청 페이지","description":"","imageUrl":"","eventAt":null,"location":"","buttonText":"신청하기","accentColor":"#4f46e5","fields":[{"id":"email","label":"이메일","type":"email","required":true},{"id":"name","label":"이름","type":"text","required":true}],"privacyText":"","marketingEnabled":false,"marketingText":"","successTitle":"신청이 완료되었습니다","successMessage":"신청해 주셔서 감사합니다.","successLinkLabel":"","successLinkUrl":"","closesAt":null,"followUp":{"enabled":false,"sourceCampaignId":null,"timing":"immediate","scheduledAt":null,"latePolicy":"skip"}},"published":null,"revision":1,"publishedRevision":null,"createdAt":"2026-10-08T02:00:00.000Z","updatedAt":"2026-10-08T02:00:00.000Z","contactSyncEnabled":false}},"schema":{"type":"object","properties":{"form":{"$ref":"#/components/schemas/Form"}},"required":["form"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"patch":{"tags":["신청 페이지"],"operationId":"form-update","summary":"신청 페이지 수정","description":"확인한 버전의 초안을 저장하거나 게시된 페이지를 닫기·다시 열기 처리합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"expectedRevision":1,"draft":{"purpose":"general","title":"행사 참가 신청","description":"","imageUrl":"","eventAt":null,"location":"","buttonText":"신청하기","accentColor":"#4f46e5","fields":[{"id":"email","label":"이메일","type":"email","required":true},{"id":"name","label":"이름","type":"text","required":true}],"privacyText":"","marketingEnabled":false,"marketingText":"","successTitle":"신청이 완료되었습니다","successMessage":"신청해 주셔서 감사합니다.","successLinkLabel":"","successLinkUrl":"","closesAt":null,"followUp":{"enabled":false,"sourceCampaignId":null,"timing":"immediate","scheduledAt":null,"latePolicy":"skip"}}},"schema":{"type":"object","properties":{"expectedRevision":{"type":"integer","minimum":1},"draft":{"$ref":"#/components/schemas/FormConfig"},"status":{"type":"string","enum":["closed","published"]}},"required":["expectedRevision"],"anyOf":[{"required":["draft"]},{"required":["status"]}]}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"form":{"id":"c47fdbfa-5b24-40ee-95b4-d81f428cc4b3","slug":"example-form","title":"행사 참가 신청","status":"draft","draft":{"purpose":"general","title":"행사 참가 신청","description":"","imageUrl":"","eventAt":null,"location":"","buttonText":"신청하기","accentColor":"#4f46e5","fields":[{"id":"email","label":"이메일","type":"email","required":true},{"id":"name","label":"이름","type":"text","required":true}],"privacyText":"","marketingEnabled":false,"marketingText":"","successTitle":"신청이 완료되었습니다","successMessage":"신청해 주셔서 감사합니다.","successLinkLabel":"","successLinkUrl":"","closesAt":null,"followUp":{"enabled":false,"sourceCampaignId":null,"timing":"immediate","scheduledAt":null,"latePolicy":"skip"}},"published":null,"revision":2,"publishedRevision":null,"createdAt":"2026-10-08T02:00:00.000Z","updatedAt":"2026-10-08T02:00:00.000Z","contactSyncEnabled":false}},"schema":{"type":"object","properties":{"form":{"$ref":"#/components/schemas/Form"}},"required":["form"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["신청 페이지"],"operationId":"form-delete","summary":"신청 페이지 삭제","description":"조회한 삭제 범위가 그대로일 때 페이지와 관련 신청 데이터를 삭제합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"expectedRevision":1,"confirmationToken":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"},"schema":{"type":"object","properties":{"expectedRevision":{"type":"integer","minimum":1},"confirmationToken":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["expectedRevision","confirmationToken"]}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"id":"c47fdbfa-5b24-40ee-95b4-d81f428cc4b3"},"schema":{"type":"object","properties":{"success":{"const":true},"id":{"type":"string","format":"uuid"}},"required":["success","id"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/forms/{id}/deletion-preview":{"get":{"tags":["신청 페이지"],"operationId":"form-delete-preview","summary":"신청 페이지 삭제 영향 확인","description":"삭제할 신청 내역·배포 링크·대기 메일과 확인 토큰을 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"preview":{"id":"c47fdbfa-5b24-40ee-95b4-d81f428cc4b3","title":"새 신청 페이지","status":"draft","expectedRevision":1,"entryCount":0,"visitCount":0,"distributionLinkCount":0,"segmentCount":0,"scheduledMailCount":0,"handedOffMailCount":0,"confirmationToken":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}},"schema":{"type":"object","properties":{"preview":{"$ref":"#/components/schemas/FormDeletionPreview"}},"required":["preview"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/forms/{id}/publish":{"post":{"tags":["신청 페이지"],"operationId":"form-publish","summary":"신청 페이지 게시","description":"필수 질문·안내·후속메일 설정을 검토한 초안을 게시합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"expectedRevision":2},"schema":{"type":"object","properties":{"expectedRevision":{"type":"integer","minimum":1}},"required":["expectedRevision"]}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"form":{"id":"c47fdbfa-5b24-40ee-95b4-d81f428cc4b3","slug":"example-form","title":"새 신청 페이지","status":"published","draft":{"purpose":"general","title":"새 신청 페이지","description":"","imageUrl":"","eventAt":null,"location":"","buttonText":"신청하기","accentColor":"#4f46e5","fields":[{"id":"email","label":"이메일","type":"email","required":true},{"id":"name","label":"이름","type":"text","required":true}],"privacyText":"개인정보 수집·이용 안내","marketingEnabled":false,"marketingText":"","successTitle":"신청이 완료되었습니다","successMessage":"신청해 주셔서 감사합니다.","successLinkLabel":"","successLinkUrl":"","closesAt":null,"followUp":{"enabled":false,"sourceCampaignId":null,"timing":"immediate","scheduledAt":null,"latePolicy":"skip"}},"published":{"purpose":"general","title":"새 신청 페이지","description":"","imageUrl":"","eventAt":null,"location":"","buttonText":"신청하기","accentColor":"#4f46e5","fields":[{"id":"email","label":"이메일","type":"email","required":true},{"id":"name","label":"이름","type":"text","required":true}],"privacyText":"개인정보 수집·이용 안내","marketingEnabled":false,"marketingText":"","successTitle":"신청이 완료되었습니다","successMessage":"신청해 주셔서 감사합니다.","successLinkLabel":"","successLinkUrl":"","closesAt":null,"followUp":{"enabled":false,"sourceCampaignId":null,"timing":"immediate","scheduledAt":null,"latePolicy":"skip"}},"revision":2,"publishedRevision":2,"createdAt":"2026-10-08T02:00:00.000Z","updatedAt":"2026-10-08T02:00:00.000Z","contactSyncEnabled":false}},"schema":{"type":"object","properties":{"form":{"$ref":"#/components/schemas/Form"}},"required":["form"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/forms/{id}/copy":{"post":{"tags":["신청 페이지"],"operationId":"form-copy","summary":"신청 페이지 복사","description":"초안을 새 주소의 비공개 페이지로 복사합니다. 후속메일과 이전 일정은 해제합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"form":{"id":"b6dc8d63-cff2-4f9c-a0d7-c2d8bcb21b76","slug":"example-form","title":"새 신청 페이지 (복사)","status":"draft","draft":{"purpose":"general","title":"새 신청 페이지","description":"","imageUrl":"","eventAt":null,"location":"","buttonText":"신청하기","accentColor":"#4f46e5","fields":[{"id":"email","label":"이메일","type":"email","required":true},{"id":"name","label":"이름","type":"text","required":true}],"privacyText":"","marketingEnabled":false,"marketingText":"","successTitle":"신청이 완료되었습니다","successMessage":"신청해 주셔서 감사합니다.","successLinkLabel":"","successLinkUrl":"","closesAt":null,"followUp":{"enabled":false,"sourceCampaignId":null,"timing":"immediate","scheduledAt":null,"latePolicy":"skip"}},"published":null,"revision":1,"publishedRevision":null,"createdAt":"2026-10-08T02:00:00.000Z","updatedAt":"2026-10-08T02:00:00.000Z","contactSyncEnabled":false}},"schema":{"type":"object","properties":{"form":{"$ref":"#/components/schemas/Form"}},"required":["form"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/forms/{id}/entries":{"get":{"tags":["신청 페이지"],"operationId":"form-entry-list","summary":"신청 내역 목록","description":"답변·동의·유입 경로·안내메일 상태를 페이지당 25건 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100000,"default":1}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":254}},{"name":"source","in":"query","required":false,"schema":{"type":"string","maxLength":500}},{"name":"basis","in":"query","required":false,"schema":{"type":"string","enum":["first","visit","credited"],"default":"credited"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","enum":["all","7d","30d","90d","180d","365d"],"default":"all"}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","description":"UTC Z 형식. 현재보다 24시간 이내 과거 또는 5분 이내 미래의 보고서 기준 시각"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"entries":[],"total":0,"page":1,"pageSize":25,"period":"all","report":{"period":"all","from":null,"to":"2026-10-08T02:00:00.000Z","cohort":"applications_submitted","outcomes":"current"}},"schema":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/FormEntry"}},"total":{"type":"integer","minimum":0},"page":{"type":"integer","minimum":1},"pageSize":{"const":25},"period":{"type":"string","enum":["all","7d","30d","90d","180d","365d"],"default":"all"},"report":{"$ref":"#/components/schemas/FormReportWindow"}},"required":["entries","total","page","pageSize","period","report"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:entries","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/forms/{id}/entries/{entryId}":{"get":{"tags":["신청 페이지"],"operationId":"form-entry-detail","summary":"신청 내역 조회","description":"특정 신청의 답변·동의·기록된 방문 경로를 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entryId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"entry":{"id":"869d156b-7354-47d9-adbc-dfae390112d3","pageId":"c47fdbfa-5b24-40ee-95b4-d81f428cc4b3","email":"sample@example.test","name":"홍길동","answers":{"email":"sample@example.test","name":"홍길동"},"formSnapshot":[{"id":"email","label":"이메일","type":"email","required":true},{"id":"name","label":"이름","type":"text","required":true}],"privacyAgreed":true,"marketingAgreed":false,"privacyText":"개인정보 수집·이용 안내","marketingText":"","submittedAt":"2026-10-08T02:00:00.000Z","attribution":{"first":{"key":"unknown","kind":"unknown","label":"직접 또는 출처 확인 불가","evidence":"unavailable"},"visit":{"key":"unknown","kind":"unknown","label":"직접 또는 출처 확인 불가","evidence":"unavailable"},"credited":{"key":"unknown","kind":"unknown","label":"직접 또는 출처 확인 불가","evidence":"unavailable"},"visitId":null,"observedAt":"2026-10-08T02:00:00.000Z","model":"last_non_direct_30d"},"delivery":null,"timeline":[]}},"schema":{"type":"object","properties":{"entry":{"$ref":"#/components/schemas/FormEntry"}},"required":["entry"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:entries","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/forms/{id}/entries/{entryId}/retry":{"post":{"tags":["신청 페이지"],"operationId":"form-entry-retry","summary":"실패한 안내메일 재시도","description":"발송 준비 단계에서 실패한 안내메일만 다시 접수합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entryId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"202":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"accepted":true},"schema":{"type":"object","properties":{"accepted":{"type":"boolean"}},"required":["accepted"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:send","x-additional-required-scopes":["forms:entries"],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/forms/{id}/entries/{entryId}/cancel":{"post":{"tags":["신청 페이지"],"operationId":"form-entry-cancel","summary":"안내메일 예약 취소","description":"발송 처리가 시작되기 전의 신청 안내메일 예약을 취소합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entryId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"cancelled":true},"schema":{"type":"object","properties":{"cancelled":{"type":"boolean"}},"required":["cancelled"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:send","x-additional-required-scopes":["forms:entries"],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/forms/{id}/sources":{"get":{"tags":["신청 페이지"],"operationId":"form-source-list","summary":"신청 유입 경로 조회","description":"배포 링크와 유입 경로별 방문·신청 수를 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"basis","in":"query","required":false,"schema":{"type":"string","enum":["first","visit","credited"],"default":"credited"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","enum":["7d","30d","90d","180d","365d"],"default":"90d"}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","description":"UTC Z 형식. 현재보다 24시간 이내 과거 또는 5분 이내 미래의 보고서 기준 시각"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"links":[],"stats":[],"totalVisits":0,"totalApplications":0,"basis":"credited","period":"90d","report":{"period":"90d","from":"2026-07-10T02:00:00.000Z","to":"2026-10-08T02:00:00.000Z","cohort":"applications_submitted","outcomes":"current"}},"schema":{"type":"object","properties":{"links":{"type":"array","items":{"$ref":"#/components/schemas/FormDistributionLink"}},"stats":{"type":"array","items":{"type":"object","properties":{"source":{"type":"object","properties":{"key":{"type":"string"},"kind":{"type":"string","enum":["email","automation","distribution","referral","unknown"]},"label":{"type":"string"},"evidence":{"type":"string","enum":["verified_email_link","distribution_link","referrer","unavailable"]},"campaignId":{"type":"integer","minimum":1},"campaignName":{"type":"string"},"mailLogId":{"type":"integer","minimum":1},"linkPosition":{"type":"integer","minimum":0},"workflowId":{"type":"integer","minimum":1},"workflowName":{"type":"string"},"stepId":{"type":"string"},"executionId":{"type":"integer","minimum":1},"distributionLinkId":{"type":"string","format":"uuid"},"channel":{"type":"string"},"referrerHost":{"type":"string"}},"required":["key","kind","label","evidence"]},"visits":{"type":"integer","minimum":0},"applications":{"type":"integer","minimum":0}},"required":[]}},"totalVisits":{"type":"integer","minimum":0},"totalApplications":{"type":"integer","minimum":0},"basis":{"type":"string","enum":["first","visit","credited"],"default":"credited"},"period":{"type":"string"},"report":{"$ref":"#/components/schemas/FormReportWindow"}},"required":["links","stats","totalVisits","totalApplications","basis","period","report"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"post":{"tags":["신청 페이지"],"operationId":"form-source-create","summary":"신청 배포 링크 만들기","description":"어디서 들어온 신청인지 구분할 배포 링크 토큰을 만듭니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"홈페이지 배너","channel":"홈페이지","channelMode":"preset"},"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"channel":{"type":"string","minLength":1,"maxLength":40},"channelMode":{"type":"string","enum":["preset","custom"]}},"required":["name","channel"]}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"source":{"id":"15c52606-8563-47d1-99fc-8a9179432bac","name":"홈페이지 배너","channel":"홈페이지","token":"example_distribution_token","createdAt":"2026-10-08T02:00:00.000Z"}},"schema":{"type":"object","properties":{"source":{"$ref":"#/components/schemas/FormDistributionLink"}},"required":["source"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/forms/{id}/audience":{"get":{"tags":["신청 페이지"],"operationId":"form-audience","summary":"신청자 활용 대상 요약","description":"전체 신청 수·마케팅 동의 수·현재 발송 가능 주소록 수를 구분합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"source","in":"query","required":false,"schema":{"type":"string"}},{"name":"basis","in":"query","required":false,"schema":{"type":"string","enum":["first","visit","credited"],"default":"credited"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"audience":{"applicants":0,"marketingConsented":0,"sendable":0,"scope":"all_applications","sendableScope":"consented_existing_eligible_contacts","sourceKey":null,"basis":"credited"}},"schema":{"type":"object","properties":{"audience":{"type":"object","properties":{"applicants":{"type":"integer","minimum":0},"marketingConsented":{"type":"integer","minimum":0},"sendable":{"type":"integer","minimum":0},"scope":{"const":"all_applications"},"sendableScope":{"const":"consented_existing_eligible_contacts"},"sourceKey":{"type":["string","null"]},"basis":{"type":"string","enum":["first","visit","credited"],"default":"credited"}},"required":["applicants","marketingConsented","sendable","scope","sendableScope","sourceKey","basis"]}},"required":["audience"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/forms/{id}/segments":{"get":{"tags":["신청 페이지"],"operationId":"form-segment-list","summary":"신청자 세그먼트와 연결 설정","description":"연결된 세그먼트·선택 가능한 세그먼트·주소록 항목 연결 설정을 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"segments":[],"availableSegments":[],"fields":[{"id":"name","label":"이름","type":"text"}],"contactTargets":[{"key":"name","label":"이름","type":"text"}],"contactSyncEnabled":false,"contactSyncOptions":{"updateExisting":false,"fieldMappings":{"name":"name"}}},"schema":{"type":"object","properties":{"segments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"name":{"type":"string"},"applicants":{"type":"integer","minimum":0},"sendable":{"type":"integer","minimum":0}},"required":["id","name","applicants","sendable"]}},"availableSegments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"name":{"type":"string"},"conditionsFingerprint":{"type":"string"}},"required":[]}},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"type":{"type":"string"}},"required":["id","label","type"]}},"contactTargets":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"type":{"type":"string"}},"required":[]}},"contactSyncEnabled":{"type":"boolean"},"contactSyncOptions":{"type":"object","properties":{"updateExisting":{"type":"boolean"},"fieldMappings":{"type":"object","additionalProperties":{"type":"string"},"description":"신청 질문 ID → contactTargets에 반환된 주소록 항목 key"}},"required":["updateExisting","fieldMappings"]}},"required":["segments","availableSegments","fields","contactTargets","contactSyncEnabled","contactSyncOptions"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:read","x-additional-required-scopes":["segments:read"],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"post":{"tags":["신청 페이지"],"operationId":"form-segment-create","summary":"신청자 세그먼트 연결","description":"신청 조건을 새 세그먼트 또는 확인한 기존 세그먼트에 연결합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"행사 신청자","marketingOnly":true,"connectConsentingApplicants":false},"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":100},"segmentId":{"type":"integer","minimum":1},"sourceKey":{"type":["string","null"]},"basis":{"type":"string","enum":["first","visit","credited"],"default":"credited"},"marketingOnly":{"type":"boolean"},"connectConsentingApplicants":{"type":"boolean"},"acknowledgeAutomations":{"type":"boolean"},"acknowledgeExistingSegmentExpansion":{"type":"boolean"},"expectedConditionsFingerprint":{"type":"string","pattern":"^[a-f0-9]{64}$"},"contactSyncOptions":{"type":"object","properties":{"updateExisting":{"type":"boolean"},"fieldMappings":{"type":"object","additionalProperties":{"type":"string"},"description":"신청 질문 ID → contactTargets에 반환된 주소록 항목 key"}},"required":["updateExisting","fieldMappings"]}},"required":[],"anyOf":[{"required":["name"]},{"required":["segmentId","expectedConditionsFingerprint","acknowledgeExistingSegmentExpansion"]}]}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"segment":{"id":1,"name":"행사 신청자","applicants":0,"sendable":0},"sync":{"connected":0,"existing":0,"suppressed":0,"limitReached":0,"updated":0,"skippedStale":0,"skippedInvalid":0,"failed":0},"contactSyncEnabled":false},"schema":{"type":"object","properties":{"segment":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"name":{"type":"string"},"applicants":{"type":"integer","minimum":0},"sendable":{"type":"integer","minimum":0}},"required":["id","name","applicants","sendable"]},"sync":{"type":"object","properties":{"connected":{"type":"integer","minimum":0},"existing":{"type":"integer","minimum":0},"suppressed":{"type":"integer","minimum":0},"limitReached":{"type":"integer","minimum":0},"updated":{"type":"integer","minimum":0},"skippedStale":{"type":"integer","minimum":0},"skippedInvalid":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0}},"required":[]},"contactSyncEnabled":{"type":"boolean"},"contactSyncOptions":{"type":"object","properties":{"updateExisting":{"type":"boolean"},"fieldMappings":{"type":"object","additionalProperties":{"type":"string"},"description":"신청 질문 ID → contactTargets에 반환된 주소록 항목 key"}},"required":["updateExisting","fieldMappings"]}},"required":["segment","sync","contactSyncEnabled"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:write","x-additional-required-scopes":["segments:write"],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/forms/{id}/contact-sync":{"patch":{"tags":["신청 페이지"],"operationId":"form-contact-sync-update","summary":"신청자 주소록 연결 설정","description":"이미 켜진 주소록 연결의 항목 대응과 기존 프로필 갱신 여부를 저장합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"acknowledgeAutomations":true,"contactSyncOptions":{"updateExisting":false,"fieldMappings":{"name":"name"}}},"schema":{"type":"object","properties":{"acknowledgeAutomations":{"const":true},"contactSyncOptions":{"type":"object","properties":{"updateExisting":{"type":"boolean"},"fieldMappings":{"type":"object","additionalProperties":{"type":"string"},"description":"신청 질문 ID → contactTargets에 반환된 주소록 항목 key"}},"required":["updateExisting","fieldMappings"]}},"required":["acknowledgeAutomations","contactSyncOptions"]}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"sync":{"connected":0,"existing":0,"suppressed":0,"limitReached":0,"updated":0,"skippedStale":0,"skippedInvalid":0,"failed":0},"contactSyncEnabled":true,"contactSyncOptions":{"updateExisting":false,"fieldMappings":{"name":"name"}}},"schema":{"type":"object","properties":{"sync":{"type":"object","properties":{"connected":{"type":"integer","minimum":0},"existing":{"type":"integer","minimum":0},"suppressed":{"type":"integer","minimum":0},"limitReached":{"type":"integer","minimum":0},"updated":{"type":"integer","minimum":0},"skippedStale":{"type":"integer","minimum":0},"skippedInvalid":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0}},"required":[]},"contactSyncEnabled":{"const":true},"contactSyncOptions":{"type":"object","properties":{"updateExisting":{"type":"boolean"},"fieldMappings":{"type":"object","additionalProperties":{"type":"string"},"description":"신청 질문 ID → contactTargets에 반환된 주소록 항목 key"}},"required":["updateExisting","fieldMappings"]}},"required":["sync","contactSyncEnabled","contactSyncOptions"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:write","x-additional-required-scopes":["segments:write","address_books:write","subscribers:write"],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["신청 페이지"],"operationId":"form-contact-sync-disable","summary":"신청자 주소록 연결 끄기","description":"이후 신청자의 자동 주소록 연결을 중단합니다. 기존 주소록은 보존합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"contactSyncEnabled":false},"schema":{"type":"object","properties":{"contactSyncEnabled":{"const":false}},"required":["contactSyncEnabled"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:write","x-additional-required-scopes":["segments:write","address_books:write","subscribers:write"],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/forms/mail-options":{"get":{"tags":["신청 페이지"],"operationId":"form-mail-options","summary":"안내메일 원본 선택 목록","description":"안내메일 구성에 참고할 수 있는 소유 캠페인의 발신 정보 목록입니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"options":[]},"schema":{"type":"object","properties":{"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"title":{"type":"string"},"subject":{"type":"string"},"senderEmail":{"type":"string"}},"required":["id","title","subject","senderEmail"]}}},"required":["options"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/forms/{id}/mail-report":{"get":{"tags":["신청 페이지"],"operationId":"form-mail-report","summary":"신청 안내메일 결과","description":"선택한 기간의 신청자에 대한 현재 안내메일 결과·열람·클릭을 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","enum":["all","7d","30d","90d","180d","365d"],"default":"all"}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","description":"UTC Z 형식. 현재보다 24시간 이내 과거 또는 5분 이내 미래의 보고서 기준 시각"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"stats":{"total":0,"scheduled":0,"queued":0,"sent":0,"failed":0,"skipped":0,"unknown":0,"cancelled":0,"opened":0,"clicked":0,"openRate":0,"clickRate":0},"report":{"period":"all","from":null,"to":"2026-10-08T02:00:00.000Z","cohort":"applications_submitted","outcomes":"current"}},"schema":{"type":"object","properties":{"stats":{"type":"object","properties":{"total":{"type":"number","minimum":0},"scheduled":{"type":"number","minimum":0},"queued":{"type":"number","minimum":0},"sent":{"type":"number","minimum":0},"failed":{"type":"number","minimum":0},"skipped":{"type":"number","minimum":0},"unknown":{"type":"number","minimum":0},"cancelled":{"type":"number","minimum":0},"opened":{"type":"number","minimum":0},"clicked":{"type":"number","minimum":0},"openRate":{"type":"number","minimum":0},"clickRate":{"type":"number","minimum":0}},"required":[]},"report":{"$ref":"#/components/schemas/FormReportWindow"}},"required":["stats","report"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"forms:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"reports","limit":100,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/newsletter-page":{"get":{"tags":["뉴스레터"],"operationId":"newsletter-page-get","summary":"뉴스레터 페이지 조회","description":"계정의 뉴스레터 페이지와 설정을 조회합니다. 아직 만들지 않았다면 page는 null입니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"page":{"id":1,"slug":"news","name":"우리의 소식","public":true,"primaryColor":"#6366F1"}},"schema":{"type":"object","properties":{"page":{"anyOf":[{"type":"object","properties":{"id":{"type":"integer","minimum":1},"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,99}$"},"name":{"type":"string","maxLength":2000},"shortDescription":{"type":"string","maxLength":2000},"description":{"type":"string","maxLength":20000},"ogTitle":{"type":"string","maxLength":2000},"ogDescription":{"type":"string","maxLength":2000},"ogImageUrl":{"type":["string","null"],"maxLength":2048},"primaryColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"public":{"type":"boolean"},"socialLinks":{"type":"array","items":{"type":"object","additionalProperties":true}},"settings":{"type":"object","additionalProperties":true,"description":"페이지의 디자인 설정. 최대 32MB. 기존 값을 조회하여 필요한 부분만 수정합니다."},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":[]},{"type":"null"}]}},"required":["page"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"newsletters:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"post":{"tags":["뉴스레터"],"operationId":"newsletter-page-create","summary":"뉴스레터 페이지 만들기","description":"계정당 하나의 뉴스레터 페이지를 만듭니다. 이미 있으면 409를 반환합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"slug":"news","name":"우리의 소식","public":true},"schema":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,99}$"},"name":{"type":"string","maxLength":2000},"shortDescription":{"type":"string","maxLength":2000},"description":{"type":"string","maxLength":20000},"ogTitle":{"type":"string","maxLength":2000},"ogDescription":{"type":"string","maxLength":2000},"ogImageUrl":{"type":["string","null"],"maxLength":2048},"primaryColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"public":{"type":"boolean"},"socialLinks":{"type":"array","items":{"type":"object","additionalProperties":true}},"settings":{"type":"object","additionalProperties":true,"description":"페이지의 디자인 설정. 최대 32MB. 기존 값을 조회하여 필요한 부분만 수정합니다."}},"required":["slug"],"additionalProperties":false}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"page":{"id":1,"slug":"news","name":"우리의 소식","public":true,"primaryColor":"#6366F1"}},"schema":{"type":"object","properties":{"page":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,99}$"},"name":{"type":"string","maxLength":2000},"shortDescription":{"type":"string","maxLength":2000},"description":{"type":"string","maxLength":20000},"ogTitle":{"type":"string","maxLength":2000},"ogDescription":{"type":"string","maxLength":2000},"ogImageUrl":{"type":["string","null"],"maxLength":2048},"primaryColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"public":{"type":"boolean"},"socialLinks":{"type":"array","items":{"type":"object","additionalProperties":true}},"settings":{"type":"object","additionalProperties":true,"description":"페이지의 디자인 설정. 최대 32MB. 기존 값을 조회하여 필요한 부분만 수정합니다."},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":[]}},"required":["page"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"newsletters:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"patch":{"tags":["뉴스레터"],"operationId":"newsletter-page-update","summary":"뉴스레터 페이지 수정","description":"보낸 항목만 변경합니다. 생략한 주소·소개·디자인 설정은 유지됩니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"새로운 소식","public":true},"schema":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,99}$"},"name":{"type":"string","maxLength":2000},"shortDescription":{"type":"string","maxLength":2000},"description":{"type":"string","maxLength":20000},"ogTitle":{"type":"string","maxLength":2000},"ogDescription":{"type":"string","maxLength":2000},"ogImageUrl":{"type":["string","null"],"maxLength":2048},"primaryColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"public":{"type":"boolean"},"socialLinks":{"type":"array","items":{"type":"object","additionalProperties":true}},"settings":{"type":"object","additionalProperties":true,"description":"페이지의 디자인 설정. 최대 32MB. 기존 값을 조회하여 필요한 부분만 수정합니다."}},"required":[],"minProperties":1,"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"page":{"id":1,"slug":"news","name":"우리의 소식","public":true,"primaryColor":"#6366F1"}},"schema":{"type":"object","properties":{"page":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,99}$"},"name":{"type":"string","maxLength":2000},"shortDescription":{"type":"string","maxLength":2000},"description":{"type":"string","maxLength":20000},"ogTitle":{"type":"string","maxLength":2000},"ogDescription":{"type":"string","maxLength":2000},"ogImageUrl":{"type":["string","null"],"maxLength":2048},"primaryColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"public":{"type":"boolean"},"socialLinks":{"type":"array","items":{"type":"object","additionalProperties":true}},"settings":{"type":"object","additionalProperties":true,"description":"페이지의 디자인 설정. 최대 32MB. 기존 값을 조회하여 필요한 부분만 수정합니다."},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":[]}},"required":["page"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"newsletters:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/newsletter-page/availability":{"get":{"tags":["뉴스레터"],"operationId":"newsletter-page-availability","summary":"뉴스레터 주소 확인","description":"원하는 페이지 주소를 사용할 수 있는지 확인합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"slug","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,99}$"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"slug":"news","available":true,"own":false},"schema":{"type":"object","properties":{"slug":{"type":"string"},"available":{"type":"boolean"},"own":{"type":"boolean"}},"required":["slug","available","own"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"newsletters:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/newsletter-issues":{"get":{"tags":["뉴스레터"],"operationId":"newsletter-issue-list","summary":"뉴스레터 글 목록","description":"계정의 글을 최신 생성순으로 조회합니다. 목록에서는 본문 HTML을 생략합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["draft","scheduled","published","sent"]}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"issues":[{"id":10,"pageId":1,"campaignId":null,"title":"10월 소식","previewText":"이번 달의 소식을 전합니다.","html":"<p>반갑습니다.</p>","tags":["소식"],"status":"draft","public":true,"publishedAt":null}],"pagination":{"page":1,"limit":20,"total":1,"totalPages":1}},"schema":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"pageId":{"type":["integer","null"]},"campaignId":{"type":["integer","null"]},"title":{"type":"string","minLength":1,"maxLength":500},"previewText":{"type":"string","maxLength":2000},"html":{"type":"string","description":"본문 HTML. 최대 20MB. 보안 정제를 거쳐 저장합니다."},"tags":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":50},"public":{"type":"boolean"},"coverImageUrl":{"type":["string","null"],"maxLength":2048},"status":{"type":"string","enum":["draft","scheduled","published","sent"]},"publishedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":[]}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["issues","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"newsletters:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"post":{"tags":["뉴스레터"],"operationId":"newsletter-issue-create","summary":"뉴스레터 글 작성","description":"작성중 글을 만듭니다. campaignId를 보내면 해당 캠페인의 본문을 복사하며 campaigns:read 권한이 추가로 필요합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"title":"10월 소식","html":"<p>반갑습니다.</p>","tags":["소식"]},"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":500},"previewText":{"type":"string","maxLength":2000},"html":{"type":"string","description":"본문 HTML. 최대 20MB. 보안 정제를 거쳐 저장합니다."},"tags":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":50},"public":{"type":"boolean"},"coverImageUrl":{"type":["string","null"],"maxLength":2048},"campaignId":{"type":"integer","minimum":1}},"required":["title"],"additionalProperties":false}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"issue":{"id":10,"pageId":1,"campaignId":null,"title":"10월 소식","previewText":"이번 달의 소식을 전합니다.","html":"<p>반갑습니다.</p>","tags":["소식"],"status":"draft","public":true,"publishedAt":null}},"schema":{"type":"object","properties":{"issue":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"pageId":{"type":["integer","null"]},"campaignId":{"type":["integer","null"]},"title":{"type":"string","minLength":1,"maxLength":500},"previewText":{"type":"string","maxLength":2000},"html":{"type":"string","description":"본문 HTML. 최대 20MB. 보안 정제를 거쳐 저장합니다."},"tags":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":50},"public":{"type":"boolean"},"coverImageUrl":{"type":["string","null"],"maxLength":2048},"status":{"type":"string","enum":["draft","scheduled","published","sent"]},"publishedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":[]}},"required":["issue"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"newsletters:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/newsletter-issues/{id}":{"get":{"tags":["뉴스레터"],"operationId":"newsletter-issue-detail","summary":"뉴스레터 글 상세","description":"본문과 게시 상태를 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"issue":{"id":10,"pageId":1,"campaignId":null,"title":"10월 소식","previewText":"이번 달의 소식을 전합니다.","html":"<p>반갑습니다.</p>","tags":["소식"],"status":"draft","public":true,"publishedAt":null}},"schema":{"type":"object","properties":{"issue":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"pageId":{"type":["integer","null"]},"campaignId":{"type":["integer","null"]},"title":{"type":"string","minLength":1,"maxLength":500},"previewText":{"type":"string","maxLength":2000},"html":{"type":"string","description":"본문 HTML. 최대 20MB. 보안 정제를 거쳐 저장합니다."},"tags":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":50},"public":{"type":"boolean"},"coverImageUrl":{"type":["string","null"],"maxLength":2048},"status":{"type":"string","enum":["draft","scheduled","published","sent"]},"publishedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":[]}},"required":["issue"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"newsletters:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"patch":{"tags":["뉴스레터"],"operationId":"newsletter-issue-update","summary":"뉴스레터 글 수정","description":"보낸 항목만 수정합니다. public:false로 공개 목록에서 숨길 수 있습니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"title":"10월의 새로운 소식"},"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":500},"previewText":{"type":"string","maxLength":2000},"html":{"type":"string","description":"본문 HTML. 최대 20MB. 보안 정제를 거쳐 저장합니다."},"tags":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":50},"public":{"type":"boolean"},"coverImageUrl":{"type":["string","null"],"maxLength":2048}},"required":[],"minProperties":1,"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"issue":{"id":10,"pageId":1,"campaignId":null,"title":"10월 소식","previewText":"이번 달의 소식을 전합니다.","html":"<p>반갑습니다.</p>","tags":["소식"],"status":"draft","public":true,"publishedAt":null}},"schema":{"type":"object","properties":{"issue":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"pageId":{"type":["integer","null"]},"campaignId":{"type":["integer","null"]},"title":{"type":"string","minLength":1,"maxLength":500},"previewText":{"type":"string","maxLength":2000},"html":{"type":"string","description":"본문 HTML. 최대 20MB. 보안 정제를 거쳐 저장합니다."},"tags":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":50},"public":{"type":"boolean"},"coverImageUrl":{"type":["string","null"],"maxLength":2048},"status":{"type":"string","enum":["draft","scheduled","published","sent"]},"publishedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":[]}},"required":["issue"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"newsletters:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["뉴스레터"],"operationId":"newsletter-issue-delete","summary":"뉴스레터 글 삭제","description":"해당 글을 삭제합니다. 연결된 이메일 캠페인은 유지됩니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"deletedId":10},"schema":{"type":"object","properties":{"deletedId":{"type":"integer","minimum":1}},"required":["deletedId"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"newsletters:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/newsletter-issues/{id}/publish":{"post":{"tags":["뉴스레터"],"operationId":"newsletter-issue-publish","summary":"뉴스레터 글 게시","description":"공개된 뉴스레터 페이지에 글을 게시합니다. 이메일 발송은 별도의 발송 작업으로 실행합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"issue":{"id":10,"pageId":1,"campaignId":null,"title":"10월 소식","previewText":"이번 달의 소식을 전합니다.","html":"<p>반갑습니다.</p>","tags":["소식"],"status":"published","public":true,"publishedAt":"2026-10-08T03:00:00Z"}},"schema":{"type":"object","properties":{"issue":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"pageId":{"type":["integer","null"]},"campaignId":{"type":["integer","null"]},"title":{"type":"string","minLength":1,"maxLength":500},"previewText":{"type":"string","maxLength":2000},"html":{"type":"string","description":"본문 HTML. 최대 20MB. 보안 정제를 거쳐 저장합니다."},"tags":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":50},"public":{"type":"boolean"},"coverImageUrl":{"type":["string","null"],"maxLength":2048},"status":{"type":"string","enum":["draft","scheduled","published","sent"]},"publishedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":[]}},"required":["issue"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"newsletters:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/campaigns/{id}/report":{"get":{"tags":["성과 분석"],"operationId":"campaign-report","summary":"캠페인 성과 요약","description":"실제 발송 기록과 열람·클릭 근거를 집계합니다. A/B 캠페인은 테스트와 나머지 발송을 함께 집계하고 고유 인원을 중복 제거합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"report":{"campaignId":10,"status":"sent","delivery":{"records":100,"succeeded":98,"failed":2,"pending":0,"unsubscribed":1},"engagement":{"uniqueRecipients":100,"uniqueDelivered":98,"uniqueOpeners":50,"uniqueClickers":20,"totalClicks":30,"clickRateFromDelivered":20.4,"openRateFromDelivered":51},"asOf":"2026-10-08T03:00:00Z"}},"schema":{"type":"object","properties":{"report":{"type":"object","properties":{"campaignId":{"type":"integer","minimum":1},"title":{"type":"string"},"status":{"type":"string"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"delivery":{"type":"object","properties":{"records":{"type":"integer","minimum":0},"succeeded":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"pending":{"type":"integer","minimum":0},"unsubscribed":{"type":"integer","minimum":0}},"required":[]},"engagement":{"type":"object","properties":{"uniqueRecipients":{"type":["integer","null"],"minimum":0},"uniqueDelivered":{"type":["integer","null"],"minimum":0},"uniqueOpeners":{"type":["integer","null"],"minimum":0},"uniqueClickers":{"type":["integer","null"],"minimum":0},"totalClicks":{"type":"integer","minimum":0},"clickRateFromDelivered":{"type":["number","null"]},"openRateFromDelivered":{"type":["number","null"]}},"required":[]},"asOf":{"type":["string","null"],"format":"date-time"}},"required":[]}},"required":["report"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"reports:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"reports","limit":100,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/campaigns/{id}/links":{"get":{"tags":["성과 분석"],"operationId":"campaign-report-links","summary":"링크별 클릭 통계","description":"링크별 클릭 횟수·고유 클릭 인원과 최초·최근 클릭을 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":50,"maximum":100}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"campaignId":10,"totalClicks":30,"uniqueClickers":20,"links":[{"url":"https://example.com","clicks":30,"uniqueClickers":20,"percentage":100,"avgClicksPerUser":1.5,"firstClickAt":"2026-10-08T01:00:00Z","lastClickAt":"2026-10-08T02:00:00Z"}],"pagination":{"page":1,"limit":50,"total":1,"totalPages":1}},"schema":{"type":"object","properties":{"campaignId":{"type":"integer","minimum":1},"totalClicks":{"type":"integer","minimum":0},"uniqueClickers":{"type":["integer","null"],"minimum":0},"links":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"clicks":{"type":"integer","minimum":0},"uniqueClickers":{"type":["integer","null"],"minimum":0},"percentage":{"type":["number","null"]},"avgClicksPerUser":{"type":["number","null"]},"firstClickAt":{"type":["string","null"],"format":"date-time"},"lastClickAt":{"type":["string","null"],"format":"date-time"}},"required":[]}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["campaignId","links","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"reports:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"reports","limit":100,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/campaigns/{id}/recipients":{"get":{"tags":["성과 분석"],"operationId":"campaign-report-recipients","summary":"수신자별 발송 결과","description":"수신자별 발송·열람·클릭·수신거부 시각과 실패 사유를 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":50,"maximum":100}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["all","success","failed","opened","clicked","unsubscribed","pending"],"default":"all"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"campaignId":10,"recipients":[{"id":1,"campaignId":10,"email":"reader@example.com","name":"수신자","status":"success","sentAt":"2026-10-08T01:00:00Z","openedAt":null,"clickedAt":null,"unsubscribedAt":null,"bounceType":null,"failureReason":null}],"pagination":{"page":1,"limit":50,"total":1,"totalPages":1}},"schema":{"type":"object","properties":{"campaignId":{"type":"integer","minimum":1},"recipients":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"campaignId":{"type":"integer","minimum":1},"email":{"type":"string","format":"email"},"name":{"type":"string"},"status":{"type":"string"},"sentAt":{"type":["string","null"],"format":"date-time"},"openedAt":{"type":["string","null"],"format":"date-time"},"clickedAt":{"type":["string","null"],"format":"date-time"},"unsubscribedAt":{"type":["string","null"],"format":"date-time"},"bounceType":{"type":["string","null"]},"failureReason":{"type":["string","null"]}},"required":[]}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["campaignId","recipients","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"reports:recipients","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"reports","limit":100,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/campaigns/{id}/clicks":{"get":{"tags":["성과 분석"],"operationId":"campaign-report-click-events","summary":"클릭 기록 조회","description":"수신자와 링크별 클릭 기록을 최신순으로 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":50,"maximum":100}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"campaignId":10,"events":[{"id":1,"recipientLogId":1,"email":"reader@example.com","url":"https://example.com","clickedAt":"2026-10-08T02:00:00Z"}],"pagination":{"page":1,"limit":50,"total":1,"totalPages":1}},"schema":{"type":"object","properties":{"campaignId":{"type":"integer","minimum":1},"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"recipientLogId":{"type":["integer","null"]},"email":{"type":"string"},"url":{"type":"string"},"clickedAt":{"type":["string","null"],"format":"date-time"}},"required":[]}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["campaignId","events","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"reports:recipients","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"reports","limit":100,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/campaigns/{id}/ab-test":{"get":{"tags":["A/B 테스트"],"operationId":"campaign-ab-detail","summary":"A/B 설정과 진행 상태","description":"A/B 유형·두 안·승자 결정 시각과 현재 승자를 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"abTest":{"enabled":true,"type":"time","testGroupRatio":50,"winnerMetric":"open","duration":null,"status":"draft","winner":null,"measurementEndsAt":null,"timeSchedulePolicy":"next-winning-slot-v1","variantA":{"scheduledAt":"2026-10-09T09:00:00+09:00"},"variantB":{"scheduledAt":"2026-10-09T18:00:00+09:00"}}},"schema":{"type":"object","properties":{"abTest":{"type":"object","properties":{"enabled":{"type":"boolean"},"type":{"type":["string","null"],"enum":["open","click","time",null]},"testGroupRatio":{"type":"integer"},"winnerMetric":{"type":"string"},"duration":{"type":["object","null"],"properties":{"value":{"type":"integer"},"unit":{"type":"string"}}},"status":{"type":"string"},"winner":{"type":["string","null"]},"measurementEndsAt":{"type":["string","null"],"format":"date-time"},"timeSchedulePolicy":{"type":["string","null"]},"variantA":{"type":"object","properties":{"campaignId":{"type":["integer","null"]},"subject":{"type":["string","null"]},"senderName":{"type":["string","null"]},"senderEmail":{"type":["string","null"],"format":"email"},"html":{"type":["string","null"]},"previewText":{"type":"string"},"scheduledAt":{"type":["string","null"],"format":"date-time"},"recipientCount":{"type":"integer"}},"required":[]},"variantB":{"type":"object","properties":{"campaignId":{"type":["integer","null"]},"subject":{"type":["string","null"]},"senderName":{"type":["string","null"]},"senderEmail":{"type":["string","null"],"format":"email"},"html":{"type":["string","null"]},"previewText":{"type":"string"},"scheduledAt":{"type":["string","null"],"format":"date-time"},"recipientCount":{"type":"integer"}},"required":[]}},"required":[]}},"required":["abTest"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"patch":{"tags":["A/B 테스트"],"operationId":"campaign-ab-update","summary":"A/B 초안 설정","description":"작성중 캠페인의 제목·발신자(open), 본문(click), 보내는 시각(time) 테스트를 설정합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"enabled":true,"type":"time","testGroupRatio":50,"winnerMetric":"open","scheduledAtA":"2026-10-09T09:00:00+09:00","scheduledAtB":"2026-10-09T18:00:00+09:00"},"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"type":{"type":"string","enum":["open","click","time"]},"testGroupRatio":{"type":"integer","minimum":10,"maximum":90,"default":50},"winnerMetric":{"type":"string","enum":["open","click"],"description":"open 유형은 open, click 유형은 click 고정입니다. time 유형에서만 선택합니다."},"duration":{"type":"object","properties":{"value":{"type":"integer","minimum":1,"maximum":23},"unit":{"type":"string","enum":["hours","days"]}},"required":["value","unit"]},"variantB":{"type":"object","properties":{"subject":{"type":"string"},"senderName":{"type":"string"},"senderEmail":{"type":"string","format":"email"},"previewText":{"type":"string"},"html":{"type":"string"}},"required":[]},"scheduledAtA":{"type":"string","format":"date-time"},"scheduledAtB":{"type":"string","format":"date-time"}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"abTest":{"enabled":true,"type":"time","testGroupRatio":50,"winnerMetric":"open","duration":null,"status":"draft","winner":null,"measurementEndsAt":null,"timeSchedulePolicy":"next-winning-slot-v1","variantA":{"scheduledAt":"2026-10-09T09:00:00+09:00"},"variantB":{"scheduledAt":"2026-10-09T18:00:00+09:00"}}},"schema":{"type":"object","properties":{"abTest":{"type":"object","properties":{"enabled":{"type":"boolean"},"type":{"type":["string","null"],"enum":["open","click","time",null]},"testGroupRatio":{"type":"integer"},"winnerMetric":{"type":"string"},"duration":{"type":["object","null"],"properties":{"value":{"type":"integer"},"unit":{"type":"string"}}},"status":{"type":"string"},"winner":{"type":["string","null"]},"measurementEndsAt":{"type":["string","null"],"format":"date-time"},"timeSchedulePolicy":{"type":["string","null"]},"variantA":{"type":"object","properties":{"campaignId":{"type":["integer","null"]},"subject":{"type":["string","null"]},"senderName":{"type":["string","null"]},"senderEmail":{"type":["string","null"],"format":"email"},"html":{"type":["string","null"]},"previewText":{"type":"string"},"scheduledAt":{"type":["string","null"],"format":"date-time"},"recipientCount":{"type":"integer"}},"required":[]},"variantB":{"type":"object","properties":{"campaignId":{"type":["integer","null"]},"subject":{"type":["string","null"]},"senderName":{"type":["string","null"]},"senderEmail":{"type":["string","null"],"format":"email"},"html":{"type":["string","null"]},"previewText":{"type":"string"},"scheduledAt":{"type":["string","null"],"format":"date-time"},"recipientCount":{"type":"integer"}},"required":[]}},"required":[]}},"required":["abTest"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/campaigns/{id}/ab-test/stats":{"get":{"tags":["A/B 테스트"],"operationId":"campaign-ab-stats","summary":"A/B 발송 통계","description":"접수한 전체·표본·나머지 인원, 현재 발송 단계와 승자 결정·나머지 발송 시각을 실제 성과와 구분해 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"abTest":{"enabled":true,"type":"time","testGroupRatio":90,"winnerMetric":"open","duration":null,"status":"running","winner":null,"measurementEndsAt":"2026-10-10T00:00:00.000Z","timeSchedulePolicy":"next-winning-slot-v1","variantA":{"scheduledAt":"2026-10-09T09:00:00+09:00"},"variantB":{"scheduledAt":"2026-10-09T18:00:00+09:00"}},"campaignId":10,"variants":[{"version":"a","campaignId":11,"status":"sent","metrics":{"target":1,"total":1,"success":1,"failed":0}},{"version":"b","campaignId":12,"status":"sent","metrics":{"target":1,"total":1,"success":1,"failed":0}}],"remaining":{"target":0,"total":0,"success":0,"failed":0},"total":{"target":2,"total":2,"success":2,"failed":0},"audience":{"source":"send_job_snapshot","sendJobId":"a112ac74-6e95-4b56-99a4-6fe16f2a8140","total":3,"test":2,"variantA":1,"variantB":1,"remaining":1},"progress":{"stage":"awaiting_winner","completedRecipients":2,"pendingRecipients":1,"remainingPendingRecipients":1,"winnerSelectionAt":"2026-10-10T00:00:00.000Z","remainingScheduledAt":null,"remainingScheduleConfirmed":false,"possibleRemainingSchedules":{"a":"2026-10-10T00:00:00.000Z","b":"2026-10-10T09:00:00.000Z"}}},"schema":{"type":"object","properties":{"abTest":{"type":"object","properties":{"enabled":{"type":"boolean"},"type":{"type":["string","null"],"enum":["open","click","time",null]},"testGroupRatio":{"type":"integer"},"winnerMetric":{"type":"string"},"duration":{"type":["object","null"],"properties":{"value":{"type":"integer"},"unit":{"type":"string"}}},"status":{"type":"string"},"winner":{"type":["string","null"]},"measurementEndsAt":{"type":["string","null"],"format":"date-time"},"timeSchedulePolicy":{"type":["string","null"]},"variantA":{"type":"object","properties":{"campaignId":{"type":["integer","null"]},"subject":{"type":["string","null"]},"senderName":{"type":["string","null"]},"senderEmail":{"type":["string","null"],"format":"email"},"html":{"type":["string","null"]},"previewText":{"type":"string"},"scheduledAt":{"type":["string","null"],"format":"date-time"},"recipientCount":{"type":"integer"}},"required":[]},"variantB":{"type":"object","properties":{"campaignId":{"type":["integer","null"]},"subject":{"type":["string","null"]},"senderName":{"type":["string","null"]},"senderEmail":{"type":["string","null"],"format":"email"},"html":{"type":["string","null"]},"previewText":{"type":"string"},"scheduledAt":{"type":["string","null"],"format":"date-time"},"recipientCount":{"type":"integer"}},"required":[]}},"required":[]},"campaignId":{"type":"integer"},"variants":{"type":"array","items":{"type":"object","properties":{"version":{"type":"string"},"campaignId":{"type":"integer"},"status":{"type":"string"},"scheduledAt":{"type":["string","null"],"format":"date-time"},"metrics":{"type":"object","additionalProperties":true}},"required":[]}},"remaining":{"type":"object","additionalProperties":true},"total":{"type":"object","additionalProperties":true},"audience":{"type":"object","properties":{"source":{"type":"string","enum":["send_job_snapshot","unavailable"]},"sendJobId":{"type":["string","null"],"format":"uuid"},"total":{"type":["integer","null"],"minimum":0},"test":{"type":["integer","null"],"minimum":0},"variantA":{"type":["integer","null"],"minimum":0},"variantB":{"type":["integer","null"],"minimum":0},"remaining":{"type":["integer","null"],"minimum":0}},"required":["source","sendJobId","total","test","variantA","variantB","remaining"]},"progress":{"type":"object","properties":{"stage":{"type":"string","enum":["draft","samples_scheduled","samples_sending","awaiting_winner","remaining_scheduled","remaining_sending","completed","cancelled","failed","unknown"]},"completedRecipients":{"type":"integer","minimum":0},"pendingRecipients":{"type":["integer","null"],"minimum":0},"remainingPendingRecipients":{"type":["integer","null"],"minimum":0},"winnerSelectionAt":{"type":["string","null"],"format":"date-time"},"remainingScheduledAt":{"type":["string","null"],"format":"date-time"},"remainingScheduleConfirmed":{"type":"boolean"},"possibleRemainingSchedules":{"type":["object","null"],"properties":{"a":{"type":["string","null"],"format":"date-time"},"b":{"type":["string","null"],"format":"date-time"}},"required":["a","b"]}},"required":["stage","completedRecipients","pendingRecipients","remainingPendingRecipients","winnerSelectionAt","remainingScheduledAt","remainingScheduleConfirmed","possibleRemainingSchedules"]}},"required":["abTest","campaignId","variants","remaining","total","audience","progress"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"reports","limit":100,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/attachments":{"post":{"tags":["첨부파일"],"operationId":"attachment-upload","summary":"첨부파일 업로드","description":"Base64 파일을 업로드하고 캠페인에 연결할 ID를 받습니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"fileName":"안내.txt","contentType":"text/plain","contentBase64":"SGVsbG8="},"schema":{"type":"object","additionalProperties":false,"properties":{"fileName":{"type":"string","minLength":1,"maxLength":255},"contentType":{"type":"string","default":"application/octet-stream"},"contentBase64":{"type":"string","contentEncoding":"base64","maxLength":6990508}},"required":["fileName","contentBase64"]}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"attachment":{"id":"550e8400-e29b-41d4-a716-446655440000","fileName":"안내.txt","contentType":"text/plain","size":5,"sha256":"185f8db32271fe25f561a6fc938b2e264306ec304eda518007d1764826381969","createdAt":"2026-10-08T00:00:00.000Z"}},"schema":{"type":"object","properties":{"attachment":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"fileName":{"type":"string"},"contentType":{"type":"string"},"size":{"type":"integer","minimum":1,"maximum":5242880},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"createdAt":{"type":"string","format":"date-time"}},"required":["id","fileName","contentType","size","sha256","createdAt"]}},"required":["attachment"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"attachments:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"get":{"tags":["첨부파일"],"operationId":"attachment-list","summary":"첨부파일 목록","description":"현재 계정이 API로 업로드한 파일의 메타데이터를 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"attachments":[{"id":"550e8400-e29b-41d4-a716-446655440000","fileName":"안내.txt","contentType":"text/plain","size":5,"sha256":"185f8db32271fe25f561a6fc938b2e264306ec304eda518007d1764826381969","createdAt":"2026-10-08T00:00:00.000Z"}],"pagination":{"page":1,"limit":20,"total":1,"totalPages":1}},"schema":{"type":"object","properties":{"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"fileName":{"type":"string"},"contentType":{"type":"string"},"size":{"type":"integer","minimum":1,"maximum":5242880},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"createdAt":{"type":"string","format":"date-time"}},"required":["id","fileName","contentType","size","sha256","createdAt"]}},"pagination":{"type":"object","properties":{"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"},"totalPages":{"type":"integer"}}}},"required":["attachments","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"attachments:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/attachments/{id}":{"get":{"tags":["첨부파일"],"operationId":"attachment-detail","summary":"첨부파일 조회","description":"파일명·크기·유형·원문 해시를 조회합니다. 파일 원문은 반환하지 않습니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"attachment":{"id":"550e8400-e29b-41d4-a716-446655440000","fileName":"안내.txt","contentType":"text/plain","size":5,"sha256":"185f8db32271fe25f561a6fc938b2e264306ec304eda518007d1764826381969","createdAt":"2026-10-08T00:00:00.000Z"}},"schema":{"type":"object","properties":{"attachment":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"fileName":{"type":"string"},"contentType":{"type":"string"},"size":{"type":"integer","minimum":1,"maximum":5242880},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"createdAt":{"type":"string","format":"date-time"}},"required":["id","fileName","contentType","size","sha256","createdAt"]}},"required":["attachment"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"attachments:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["첨부파일"],"operationId":"attachment-delete","summary":"미사용 첨부파일 삭제","description":"캠페인과 발송 작업이 참조하지 않는 파일만 삭제합니다. 사용 중이면 409를 반환합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"deletedId":"550e8400-e29b-41d4-a716-446655440000"},"schema":{"type":"object","properties":{"success":{"const":true},"deletedId":{"type":"string","format":"uuid"}},"required":["success","deletedId"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"attachments:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/address-books":{"get":{"tags":["주소록"],"operationId":"address-book-list","summary":"주소록 목록","description":"API로 만든 주소록과 소속 그룹을 조회합니다.\n운영 제공: 엔터프라이즈 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"addressBooks":[{"id":10,"name":"고객 소식","description":"고객 뉴스레터","senderName":"이지센더","senderEmail":"sender@example.test","companyName":"회사","companyContact":"02-0000-0000","companyAddress":"서울","groupIds":[11],"createdAt":"2026-10-08T00:00:00Z","updatedAt":"2026-10-08T00:00:00Z"}]},"schema":{"type":"object","properties":{"addressBooks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":2000},"senderName":{"type":"string","maxLength":100},"senderEmail":{"type":"string","maxLength":254},"companyName":{"type":"string","maxLength":200},"companyContact":{"type":"string","maxLength":200},"companyAddress":{"type":"string","maxLength":1000},"groupIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","description","senderName","senderEmail","companyName","companyContact","companyAddress","groupIds","createdAt","updatedAt"]}}},"required":["addressBooks"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"address_books:read","x-additional-required-scopes":[],"x-required-live-plan":"enterprise","x-live-plan-description":"엔터프라이즈 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"post":{"tags":["주소록"],"operationId":"address-book-create","summary":"주소록 만들기","description":"주소록 설정과 빈 기본 그룹을 함께 만듭니다.\n운영 제공: 엔터프라이즈 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"고객 소식","senderName":"이지센더"},"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":2000},"senderName":{"type":"string","maxLength":100},"senderEmail":{"type":"string","maxLength":254},"companyName":{"type":"string","maxLength":200},"companyContact":{"type":"string","maxLength":200},"companyAddress":{"type":"string","maxLength":1000}},"required":["name"],"additionalProperties":false}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"addressBook":{"id":10,"name":"고객 소식","description":"고객 뉴스레터","senderName":"이지센더","senderEmail":"sender@example.test","companyName":"회사","companyContact":"02-0000-0000","companyAddress":"서울","groupIds":[11],"createdAt":"2026-10-08T00:00:00Z","updatedAt":"2026-10-08T00:00:00Z"}},"schema":{"type":"object","properties":{"addressBook":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":2000},"senderName":{"type":"string","maxLength":100},"senderEmail":{"type":"string","maxLength":254},"companyName":{"type":"string","maxLength":200},"companyContact":{"type":"string","maxLength":200},"companyAddress":{"type":"string","maxLength":1000},"groupIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","description","senderName","senderEmail","companyName","companyContact","companyAddress","groupIds","createdAt","updatedAt"]}},"required":["addressBook"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"address_books:write","x-additional-required-scopes":[],"x-required-live-plan":"enterprise","x-live-plan-description":"엔터프라이즈 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/address-books/{id}":{"get":{"tags":["주소록"],"operationId":"address-book-detail","summary":"주소록 조회","description":"주소록 설정과 소속 그룹 ID를 조회합니다.\n운영 제공: 엔터프라이즈 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"addressBook":{"id":10,"name":"고객 소식","description":"고객 뉴스레터","senderName":"이지센더","senderEmail":"sender@example.test","companyName":"회사","companyContact":"02-0000-0000","companyAddress":"서울","groupIds":[11],"createdAt":"2026-10-08T00:00:00Z","updatedAt":"2026-10-08T00:00:00Z"}},"schema":{"type":"object","properties":{"addressBook":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":2000},"senderName":{"type":"string","maxLength":100},"senderEmail":{"type":"string","maxLength":254},"companyName":{"type":"string","maxLength":200},"companyContact":{"type":"string","maxLength":200},"companyAddress":{"type":"string","maxLength":1000},"groupIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","description","senderName","senderEmail","companyName","companyContact","companyAddress","groupIds","createdAt","updatedAt"]}},"required":["addressBook"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"address_books:read","x-additional-required-scopes":[],"x-required-live-plan":"enterprise","x-live-plan-description":"엔터프라이즈 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"patch":{"tags":["주소록"],"operationId":"address-book-update","summary":"주소록 설정 수정","description":"이름과 발신·회사 설정을 수정합니다. 생략한 항목은 유지합니다.\n운영 제공: 엔터프라이즈 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"name":"새 고객 소식"},"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":2000},"senderName":{"type":"string","maxLength":100},"senderEmail":{"type":"string","maxLength":254},"companyName":{"type":"string","maxLength":200},"companyContact":{"type":"string","maxLength":200},"companyAddress":{"type":"string","maxLength":1000}},"required":[],"additionalProperties":false,"minProperties":1}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"addressBook":{"id":10,"name":"고객 소식","description":"고객 뉴스레터","senderName":"이지센더","senderEmail":"sender@example.test","companyName":"회사","companyContact":"02-0000-0000","companyAddress":"서울","groupIds":[11],"createdAt":"2026-10-08T00:00:00Z","updatedAt":"2026-10-08T00:00:00Z"}},"schema":{"type":"object","properties":{"addressBook":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":2000},"senderName":{"type":"string","maxLength":100},"senderEmail":{"type":"string","maxLength":254},"companyName":{"type":"string","maxLength":200},"companyContact":{"type":"string","maxLength":200},"companyAddress":{"type":"string","maxLength":1000},"groupIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","description","senderName","senderEmail","companyName","companyContact","companyAddress","groupIds","createdAt","updatedAt"]}},"required":["addressBook"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"address_books:write","x-additional-required-scopes":[],"x-required-live-plan":"enterprise","x-live-plan-description":"엔터프라이즈 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["주소록"],"operationId":"address-book-delete","summary":"주소록 삭제","description":"주소록과 연결된 그룹을 삭제합니다. 기본 설정에서는 수신자가 있으면 409로 전체 취소합니다.\n운영 제공: 엔터프라이즈 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":false,"content":{"application/json":{"example":{"deleteSubscribers":false},"schema":{"type":"object","properties":{"deleteSubscribers":{"type":"boolean","default":false}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"deletedId":10},"schema":{"type":"object","properties":{"success":{"const":true},"deletedId":{"type":"integer","minimum":1,"maximum":2147483647}},"required":["success","deletedId"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"address_books:write","x-additional-required-scopes":[],"x-required-live-plan":"enterprise","x-live-plan-description":"엔터프라이즈 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/address-books/{id}/copy":{"post":{"tags":["주소록"],"operationId":"address-book-copy","summary":"주소록 복사","description":"설정과 그룹 구성을 새 주소록으로 복사합니다. 수신자와 발송 이력은 복사하지 않습니다.\n운영 제공: 엔터프라이즈 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":false,"content":{"application/json":{"example":{"name":"고객 소식 복사"},"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100}},"required":[],"additionalProperties":false}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"addressBook":{"id":12,"name":"고객 소식","description":"고객 뉴스레터","senderName":"이지센더","senderEmail":"sender@example.test","companyName":"회사","companyContact":"02-0000-0000","companyAddress":"서울","groupIds":[13],"createdAt":"2026-10-08T00:00:00Z","updatedAt":"2026-10-08T00:00:00Z"}},"schema":{"type":"object","properties":{"addressBook":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":2000},"senderName":{"type":"string","maxLength":100},"senderEmail":{"type":"string","maxLength":254},"companyName":{"type":"string","maxLength":200},"companyContact":{"type":"string","maxLength":200},"companyAddress":{"type":"string","maxLength":1000},"groupIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","description","senderName","senderEmail","companyName","companyContact","companyAddress","groupIds","createdAt","updatedAt"]}},"required":["addressBook"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"address_books:write","x-additional-required-scopes":[],"x-required-live-plan":"enterprise","x-live-plan-description":"엔터프라이즈 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/address-books/{id}/groups":{"patch":{"tags":["주소록"],"operationId":"address-book-groups","summary":"주소록에 그룹 연결","description":"groupIds로 소속 그룹 전체를 지정합니다. []는 연결만 모두 해제하며 그룹·수신자는 보존합니다.\n운영 제공: 엔터프라이즈 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"groupIds":[11]},"schema":{"type":"object","properties":{"groupIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000}},"required":["groupIds"],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"addressBook":{"id":10,"name":"고객 소식","description":"고객 뉴스레터","senderName":"이지센더","senderEmail":"sender@example.test","companyName":"회사","companyContact":"02-0000-0000","companyAddress":"서울","groupIds":[11],"createdAt":"2026-10-08T00:00:00Z","updatedAt":"2026-10-08T00:00:00Z"}},"schema":{"type":"object","properties":{"addressBook":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":2000},"senderName":{"type":"string","maxLength":100},"senderEmail":{"type":"string","maxLength":254},"companyName":{"type":"string","maxLength":200},"companyContact":{"type":"string","maxLength":200},"companyAddress":{"type":"string","maxLength":1000},"groupIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","description","senderName","senderEmail","companyName","companyContact","companyAddress","groupIds","createdAt","updatedAt"]}},"required":["addressBook"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"address_books:write","x-additional-required-scopes":[],"x-required-live-plan":"enterprise","x-live-plan-description":"엔터프라이즈 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/address-books/groups/{id}/members":{"post":{"tags":["주소록 그룹"],"operationId":"group-members-add","summary":"그룹에 수신자 일괄 추가","description":"기존 수신자 최대 1,000명의 소속을 추가합니다. 프로필·구독 상태를 그대로 보존합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"subscriberIds":[12,13]},"schema":{"type":"object","properties":{"subscriberIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000,"minItems":1}},"required":["subscriberIds"],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"changed":2},"schema":{"type":"object","properties":{"success":{"const":true},"changed":{"type":"integer","minimum":0}},"required":["success","changed"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"subscribers:write","x-additional-required-scopes":["address_books:write"],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["주소록 그룹"],"operationId":"group-members-remove","summary":"그룹에서 수신자 일괄 제거","description":"선택한 수신자의 이 그룹 소속만 제거합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"subscriberIds":[12,13]},"schema":{"type":"object","properties":{"subscriberIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":1000,"minItems":1}},"required":["subscriberIds"],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"changed":2},"schema":{"type":"object","properties":{"success":{"const":true},"changed":{"type":"integer","minimum":0}},"required":["success","changed"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"subscribers:write","x-additional-required-scopes":["address_books:write"],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/subscribers/count":{"get":{"tags":["수신자"],"operationId":"subscriber-count","summary":"수신자 수 조회","description":"전체 또는 선택한 그룹·주소록의 고유 이메일 수와 발송 가능 수를 조회합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"groupId","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"addressBookId","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"counts":{"memberships":120,"total":100,"eligible":90,"unsubscribed":10}},"schema":{"type":"object","properties":{"counts":{"type":"object","properties":{"memberships":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0},"eligible":{"type":"integer","minimum":0},"unsubscribed":{"type":"integer","minimum":0}},"required":["memberships","total","eligible","unsubscribed"]}},"required":["counts"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"subscribers:read","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/campaigns/{id}/tags":{"get":{"tags":["이메일 캠페인"],"operationId":"campaign-tag-list","summary":"캠페인 태그 조회","description":"캠페인의 분류 태그를 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"campaignId":10,"tags":["월간","고객"]},"schema":{"type":"object","properties":{"campaignId":{"type":"integer","minimum":1,"maximum":2147483647},"tags":{"type":"array","items":{"type":"string"}}},"required":["campaignId","tags"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"post":{"tags":["이메일 캠페인"],"operationId":"campaign-tag-add","summary":"캠페인 태그 추가","description":"분류 태그를 추가합니다. 같은 태그는 중복 등록하지 않습니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"tags":["월간","고객"]},"schema":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"string","minLength":1,"maxLength":50},"maxItems":50,"minItems":1,"uniqueItems":true}},"required":["tags"],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"campaignId":10,"tags":["고객","월간"]},"schema":{"type":"object","properties":{"campaignId":{"type":"integer","minimum":1,"maximum":2147483647},"tags":{"type":"array","items":{"type":"string"}}},"required":["campaignId","tags"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["이메일 캠페인"],"operationId":"campaign-tag-remove","summary":"캠페인 태그 해제","description":"지정한 분류 태그만 해제합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"tags":["월간"]},"schema":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"string","minLength":1,"maxLength":50},"maxItems":50,"minItems":1,"uniqueItems":true}},"required":["tags"],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"campaignId":10,"tags":["고객"]},"schema":{"type":"object","properties":{"campaignId":{"type":"integer","minimum":1,"maximum":2147483647},"tags":{"type":"array","items":{"type":"string"}}},"required":["campaignId","tags"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"campaigns:write","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/reports/campaigns/query":{"post":{"tags":["성과 분석"],"operationId":"campaign-report-batch","summary":"여러 캠페인 성과 조회","description":"최대 10개 캠페인의 성과 요약을 한 요청으로 조회합니다.\n운영 제공: 프로 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"campaignIds":[10,11]},"schema":{"type":"object","properties":{"campaignIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":10,"minItems":1,"uniqueItems":true}},"required":["campaignIds"],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"reports":[{"campaignId":10,"status":"sent","delivery":{"records":100,"succeeded":98,"failed":2,"pending":0,"unsubscribed":1},"engagement":{"uniqueOpeners":50,"uniqueClickers":20}}]},"schema":{"type":"object","properties":{"reports":{"type":"array","items":{"$ref":"#/components/schemas/CampaignReport"}}},"required":["reports"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"reports:read","x-additional-required-scopes":[],"x-required-live-plan":"pro","x-live-plan-description":"프로 이상","x-rate-limit":{"bucket":"reports","limit":100,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/subscribers/campaign-stats/query":{"post":{"tags":["성과 분석"],"operationId":"subscriber-campaign-stats","summary":"수신자별 여러 캠페인 성과 조회","description":"한 이메일의 최대 30개 캠페인 발송·열람·클릭 기록을 함께 조회합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"email":"reader@example.com","campaignIds":[10,11]},"schema":{"type":"object","properties":{"email":{"type":"string","format":"email","maxLength":254},"campaignIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"maxItems":30,"minItems":1,"uniqueItems":true}},"required":["email","campaignIds"],"additionalProperties":false}}}},"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"email":"reader@example.com","stats":[{"campaignId":10,"title":"월간 소식","records":1,"delivered":1,"failedMessages":0,"bouncedMessages":0,"openedMessages":1,"firstOpenedAt":"2026-10-08T00:00:00Z","totalOpens":null,"countedSince":null,"totalClicks":3,"reportedClicks":2,"excludedAutomaticClicks":1,"unsubscribedMessages":0}]},"schema":{"type":"object","properties":{"email":{"type":"string"},"stats":{"type":"array","items":{"type":"object","properties":{"campaignId":{"type":"integer","minimum":1,"maximum":2147483647},"title":{"type":"string"},"records":{"type":"integer","minimum":0},"delivered":{"type":"integer","minimum":0},"failedMessages":{"type":"integer","minimum":0},"bouncedMessages":{"type":"integer","minimum":0},"openedMessages":{"type":"integer","minimum":0},"firstOpenedAt":{"type":["string","null"],"format":"date-time"},"totalOpens":{"type":["integer","null"],"minimum":0},"countedSince":{"type":["string","null"],"format":"date-time"},"totalClicks":{"type":"integer","minimum":0},"reportedClicks":{"type":"integer","minimum":0},"excludedAutomaticClicks":{"type":"integer","minimum":0},"unsubscribedMessages":{"type":"integer","minimum":0}},"required":["campaignId","title","records","delivered","failedMessages","bouncedMessages","openedMessages","firstOpenedAt","totalOpens","countedSince","totalClicks","reportedClicks","excludedAutomaticClicks","unsubscribedMessages"]}}},"required":["email","stats"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"reports:recipients","x-additional-required-scopes":["subscribers:read"],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"reports","limit":100,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/subscribers/double-opt-in":{"post":{"tags":["수신자"],"operationId":"subscriber-double-opt-in","summary":"구독 확인 메일 요청","description":"수신자가 확인 버튼으로 동의한 뒤 주소록에 등록합니다. 운영 키는 실제 확인 메일을 보내며, 테스트 키는 요청 결과만 모의 실행합니다.\n운영 제공: 스탠다드 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"groupId":1,"email":"subscriber@example.test","name":"홍길동"},"schema":{"type":"object","required":["groupId","email"],"additionalProperties":false,"properties":{"groupId":{"type":"integer","minimum":1,"maximum":2147483647},"email":{"type":"string","format":"email","maxLength":254},"name":{"type":"string"},"customFields":{"type":"object","maxProperties":100,"propertyNames":{"maxLength":100},"additionalProperties":{"type":"string","maxLength":1000}}}}}}},"responses":{"200":{"description":"이미 확인된 활성 수신자: 추가 확인 메일 없음","content":{"application/json":{"schema":{"type":"object","required":["confirmation"],"properties":{"confirmation":{"type":"object","required":["id","status","email","groupId","subscriberId","expiresAt","retryAfter"],"properties":{"id":{"type":["string","null"],"format":"uuid"},"status":{"type":"string","enum":["pending","already_subscribed"]},"email":{"type":"string","format":"email"},"groupId":{"type":"integer","minimum":1},"subscriberId":{"type":["integer","null"],"minimum":1},"expiresAt":{"type":["string","null"],"format":"date-time"},"retryAfter":{"type":"integer","minimum":0}}}}}}}},"202":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"confirmation":{"id":"aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee","status":"pending","email":"subscriber@example.test","groupId":1,"subscriberId":null,"expiresAt":"2026-10-09T02:00:00.000Z","retryAfter":300}},"schema":{"type":"object","required":["confirmation"],"properties":{"confirmation":{"type":"object","required":["id","status","email","groupId","subscriberId","expiresAt","retryAfter"],"properties":{"id":{"type":["string","null"],"format":"uuid"},"status":{"type":"string","enum":["pending","already_subscribed"]},"email":{"type":"string","format":"email"},"groupId":{"type":"integer","minimum":1},"subscriberId":{"type":["integer","null"],"minimum":1},"expiresAt":{"type":["string","null"],"format":"date-time"},"retryAfter":{"type":"integer","minimum":0}}}}}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"subscribers:write","x-additional-required-scopes":[],"x-required-live-plan":"standard","x-live-plan-description":"스탠다드 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/sender-identities":{"get":{"tags":["발신 정보"],"operationId":"sender-identity-list","summary":"등록 발신 주소 목록","description":"인증 대기를 포함한 계정의 등록 발신 주소를 조회합니다.\n운영 제공: 엔터프라이즈 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["all","pending","verified"],"default":"all"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"senderIdentities":[{"id":42,"email":"sender@example.com","domain":"example.com","status":"pending","isDefault":false,"verifiedAt":null,"verification":{"deliveryStatus":"accepted","sentAt":"2026-10-08T00:00:00.000Z","expiresAt":"2026-10-09T00:00:00.000Z","retryAt":"2026-10-08T00:01:00.000Z"}}],"pagination":{"page":1,"limit":20,"total":1,"totalPages":1}},"schema":{"type":"object","properties":{"senderIdentities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"email":{"type":"string","format":"email"},"domain":{"type":"string"},"status":{"type":"string","enum":["pending","verified"]},"isDefault":{"type":"boolean"},"verifiedAt":{"type":["string","null"],"format":"date-time"},"verification":{"type":"object","properties":{"deliveryStatus":{"type":["string","null"],"enum":["pending","accepted","failed","consumed","revoked","simulated",null]},"sentAt":{"type":["string","null"],"format":"date-time"},"expiresAt":{"type":["string","null"],"format":"date-time"},"retryAt":{"type":["string","null"],"format":"date-time"}},"required":["deliveryStatus","sentAt","expiresAt","retryAt"]}},"required":["id","email","domain","status","isDefault","verifiedAt","verification"]}},"pagination":{"type":"object","properties":{"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"},"totalPages":{"type":"integer"}},"required":["page","limit","total","totalPages"]}},"required":["senderIdentities","pagination"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"senders:read","x-additional-required-scopes":[],"x-required-live-plan":"enterprise","x-live-plan-description":"엔터프라이즈 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"post":{"tags":["발신 정보"],"operationId":"sender-identity-create","summary":"발신 주소 등록","description":"발신 주소를 등록하고 소유권 확인 메일을 요청합니다.\n운영 제공: 엔터프라이즈 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"requestBody":{"required":true,"content":{"application/json":{"example":{"email":"sender@example.com"},"schema":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string","format":"email","maxLength":254}},"required":["email"]}}}},"responses":{"201":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"senderIdentity":{"id":42,"email":"sender@example.com","domain":"example.com","status":"pending","isDefault":false,"verifiedAt":null,"verification":{"deliveryStatus":"accepted","sentAt":"2026-10-08T00:00:00.000Z","expiresAt":"2026-10-09T00:00:00.000Z","retryAt":"2026-10-08T00:01:00.000Z"}}},"schema":{"type":"object","properties":{"senderIdentity":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"email":{"type":"string","format":"email"},"domain":{"type":"string"},"status":{"type":"string","enum":["pending","verified"]},"isDefault":{"type":"boolean"},"verifiedAt":{"type":["string","null"],"format":"date-time"},"verification":{"type":"object","properties":{"deliveryStatus":{"type":["string","null"],"enum":["pending","accepted","failed","consumed","revoked","simulated",null]},"sentAt":{"type":["string","null"],"format":"date-time"},"expiresAt":{"type":["string","null"],"format":"date-time"},"retryAt":{"type":["string","null"],"format":"date-time"}},"required":["deliveryStatus","sentAt","expiresAt","retryAt"]}},"required":["id","email","domain","status","isDefault","verifiedAt","verification"]}},"required":["senderIdentity"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"senders:write","x-additional-required-scopes":[],"x-required-live-plan":"enterprise","x-live-plan-description":"엔터프라이즈 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/sender-identities/{id}":{"get":{"tags":["발신 정보"],"operationId":"sender-identity-detail","summary":"발신 주소 인증 상태","description":"발신 주소의 인증 여부 및 인증 메일 요청 상태를 확인합니다.\n운영 제공: 엔터프라이즈 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"senderIdentity":{"id":42,"email":"sender@example.com","domain":"example.com","status":"pending","isDefault":false,"verifiedAt":null,"verification":{"deliveryStatus":"accepted","sentAt":"2026-10-08T00:00:00.000Z","expiresAt":"2026-10-09T00:00:00.000Z","retryAt":"2026-10-08T00:01:00.000Z"}}},"schema":{"type":"object","properties":{"senderIdentity":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"email":{"type":"string","format":"email"},"domain":{"type":"string"},"status":{"type":"string","enum":["pending","verified"]},"isDefault":{"type":"boolean"},"verifiedAt":{"type":["string","null"],"format":"date-time"},"verification":{"type":"object","properties":{"deliveryStatus":{"type":["string","null"],"enum":["pending","accepted","failed","consumed","revoked","simulated",null]},"sentAt":{"type":["string","null"],"format":"date-time"},"expiresAt":{"type":["string","null"],"format":"date-time"},"retryAt":{"type":["string","null"],"format":"date-time"}},"required":["deliveryStatus","sentAt","expiresAt","retryAt"]}},"required":["id","email","domain","status","isDefault","verifiedAt","verification"]}},"required":["senderIdentity"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"senders:read","x-additional-required-scopes":[],"x-required-live-plan":"enterprise","x-live-plan-description":"엔터프라이즈 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}},"delete":{"tags":["발신 정보"],"operationId":"sender-identity-delete","summary":"발신 주소 삭제","description":"기본 주소를 제외한 등록 주소를 비활성화하고 인증 링크를 폐기합니다.\n운영 제공: 엔터프라이즈 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"success":true,"deletedId":42},"schema":{"type":"object","properties":{"success":{"const":true},"deletedId":{"type":"integer"}},"required":["success","deletedId"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"senders:write","x-additional-required-scopes":[],"x-required-live-plan":"enterprise","x-live-plan-description":"엔터프라이즈 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}},"/sender-identities/{id}/verification":{"post":{"tags":["발신 정보"],"operationId":"sender-identity-verification","summary":"발신 주소 인증 재요청","description":"인증 대기 중인 발신 주소에 새로운 인증 링크를 전송합니다.\n운영 제공: 엔터프라이즈 이상. 테스트 키는 모든 요금제에서 모의 실행할 수 있으며 업무 권한은 유지됩니다.","security":[{"ezsenderId":[],"ezsenderSecret":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"X-Ezsender-Environment","in":"header","required":false,"description":"test 또는 live. 키 환경과 다르면 실행하지 않습니다.","schema":{"type":"string","enum":["test","live"]}}],"responses":{"200":{"description":"성공","headers":{"X-Request-Id":{"description":"고객 지원과 요청 추적에 사용하는 요청 번호","schema":{"type":"string"}},"X-Ezsender-Environment":{"schema":{"type":"string","enum":["test","live"]}},"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"senderIdentity":{"id":42,"email":"sender@example.com","domain":"example.com","status":"pending","isDefault":false,"verifiedAt":null,"verification":{"deliveryStatus":"accepted","sentAt":"2026-10-08T00:00:00.000Z","expiresAt":"2026-10-09T00:00:00.000Z","retryAt":"2026-10-08T00:01:00.000Z"}}},"schema":{"type":"object","properties":{"senderIdentity":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"email":{"type":"string","format":"email"},"domain":{"type":"string"},"status":{"type":"string","enum":["pending","verified"]},"isDefault":{"type":"boolean"},"verifiedAt":{"type":["string","null"],"format":"date-time"},"verification":{"type":"object","properties":{"deliveryStatus":{"type":["string","null"],"enum":["pending","accepted","failed","consumed","revoked","simulated",null]},"sentAt":{"type":["string","null"],"format":"date-time"},"expiresAt":{"type":["string","null"],"format":"date-time"},"retryAt":{"type":["string","null"],"format":"date-time"}},"required":["deliveryStatus","sentAt","expiresAt","retryAt"]}},"required":["id","email","domain","status","isDefault","verifiedAt","verification"]}},"required":["senderIdentity"]}}}},"400":{"description":"잘못된 요청 또는 형식","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 실패 또는 만료·폐기된 키","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한·환경·요금제 제한","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"소유 리소스 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"상태 충돌 또는 요청 키 충돌","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"필수 발송 정보 부족","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 한도 초과. Retry-After를 확인하세요.","headers":{"X-RateLimit-Limit":{"description":"현재 계정·환경·기능 묶음의 호출 한도","schema":{"type":"integer"}},"X-RateLimit-Bucket":{"description":"같은 계정의 키끼리 공유하는 기능 묶음","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"집계 구간 길이(초)","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"현재 구간의 남은 요청 수","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"다음 집계 구간의 Unix 시각(초)","schema":{"type":"integer"}},"Retry-After":{"description":"재시도 전 기다릴 초","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"서버 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"일시적으로 처리할 수 없음","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-required-scope":"senders:write","x-additional-required-scopes":[],"x-required-live-plan":"enterprise","x-live-plan-description":"엔터프라이즈 이상","x-rate-limit":{"bucket":"general","limit":1000,"windowSeconds":60,"scope":"account-environment-bucket"},"x-test-rate-limit":{"bucket":"sandbox","limit":120,"windowSeconds":60,"scope":"account-environment-bucket"}}}},"x-ezsender-messages":{"enabled":false,"message":"운영 단건 알림 발송 연결이 준비되지 않아 신규 접수를 사용할 수 없습니다. 테스트 키의 모의 실행과 기존 접수 조회는 가능합니다."}}