API

그룹 관련 에러

작성일 2026.03.05 | 수정일 2026.03.05

errorCode	설명	대처 방법
InvalidGroupStatus	현재 그룹 상태에서 허용되지 않는 작업입니다.	그룹 상태를 확인하고, 해당 상태에서 가능한 작업인지 그룹 상태 표를 참조하세요.
InvalidScheduledDate	예약 일시가 유효하지 않습니다.	현재 시간 이후 ~ 6개월 이내의 ISO 8601 형식 날짜를 지정하세요.
QuotaExceeded	일일 발송 한도를 초과했습니다.	다음 날까지 기다리거나, 한도 상향을 요청하세요.
GroupInProcessing	해당 그룹이 이미 발송/처리 중입니다.	발송이 완료될 때까지 기다린 후 다시 시도하세요.
AlreadySent	이미 발송 완료된 그룹입니다.	새 그룹을 생성하여 발송하세요.
NotOperationalStatus	그룹이 운영 가능한 상태가 아닙니다.	그룹 상태를 확인해 주세요. `DELETED`나 `SYSTEM-ERROR` 상태에서는 대부분의 작업이 불가합니다.

groupId 형식 오류: groupId는 G4V로 시작하는 32자 문자열이어야 합니다. 앞뒤 공백이나 특수문자가 포함되지 않았는지 확인하세요.
messageId 형식 오류: messageId는 M4V로 시작하는 32자 문자열이어야 합니다.
criteria/cond/value 불일치: 고급 검색 시 세 파라미터의 콤마 구분 항목 수가 반드시 동일해야 합니다. 예를 들어 criteria에 2개 필드를 지정했다면 cond와 value에도 각각 2개씩 지정해야 합니다.
데이터 크기 초과: 요청 데이터가 15MB를 초과하면 에러가 발생합니다. 메시지 수를 줄여서 여러 번 나누어 호출하세요.
수신번호 초과: 한 번의 요청에 10,000건을 초과하는 수신번호를 포함할 수 없습니다. 여러 번 나누어 추가하세요.
그룹 메시지 수 초과: 하나의 그룹에 1,000,000건을 초과하는 메시지를 담을 수 없습니다. 여러 그룹으로 나누어 발송하세요.