API

그룹 생성

작성일 2026.03.04 | 수정일 2026.03.25

POST/messages/v4/groups

message:write 권한이 필요합니다

메시지를 담을 빈 그룹을 생성합니다. 그룹 메시지 발송의 첫 번째 단계이며, 생성된 그룹에 메시지를 추가한 뒤 발송을 요청하는 흐름으로 사용합니다.
생성 직후 그룹의 상태는 PENDING이며, 이 상태에서만 메시지를 추가하거나 삭제할 수 있습니다.

Body Params

모든 파라미터는 선택 사항입니다. 아무 값도 전달하지 않으면 기본 설정으로 빈 그룹이 생성됩니다.

Name	Type	Description
appId	string	솔라피 앱스토어에 등록된 앱 아이디. 앱을 통한 발송 수익을 추적할 때 사용
strict	boolean	엄격 검사 여부. 기본값: `false` - 유요하지 않은 문자 검사(아닐 시 자체적으로 삭제) - LMS나 MMS에서 제목 여부 검사(아닐 시 문자 내용에서 제목을 구함) - 템플릿을 발송 전 검사(아닐 시 발송 후 실패)
sdkVersion	string	사용 중인 SDK의 버전 정보
osPlatform	string	호출 환경의 OS 플랫폼 정보
serviceMethod	string	서비스 방식. MT(일반 메시지, 기본값) 또는 AUTH(본인인증 메시지). 본인 인증 메시지는 별도의 발송 제한과 정책이 적용됨
customFields	object	사용자 정의 메타데이터. 캠페인 구분, 내부 관리 번호 등 자유롭게 활용 가능. 최대 10개 필드, 키 30자/값 100자, 모두 문자열
hint	object	발송 시 참고할 힌트 정보
allowDuplicates	boolean	중복 수신 번호 허용 여부. 기본값: `false`

Structures

{
  "appId": "string",
  "strict": "string",
  "sdkVersion": "string",
  "osPlatform": "string",
  "customFields": "string",
  "hint": "string",
  "allowDuplicates": "string"
}

응답 구조는 그룹 객체 응답 스키마를 참조하세요.