API

그룹 생성

작성일 2026.03.04 | 수정일 2026.03.05

POST/messages/v4/groups

message:write 권한이 필요합니다

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

Body Params

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

NameTypeRequiredDescription
appIdstring솔라피 앱스토어에 등록된 앱 아이디. 앱을 통한 발송 수익을 추적할 때 사용
strictboolean엄격 검사 여부. 기본값: false
- 유요하지 않은 문자 검사(아닐 시 자체적으로 삭제)
- LMS 나 MMS에서 제목 여부 검사(아닐 시 문자 내용에서 제목을 구함)
- 템플릿을 발송 전 검사(아닐 시 발송 후 실패)
sdkVersionstring사용 중인 SDK의 버전 정보. 디버깅 및 통계 목적으로 활용
osPlatformstring호출 환경의 OS 플랫폼 정보 (예: linux, win32, darwin)
serviceMethodstring서비스 방식. MT(일반 메시지, 기본값) 또는 AUTH(본인인증 메시지). 본인인증 메시지는 별도의 발송 제한과 정책이 적용됨
customFieldsobject사용자 정의 메타 데이터. 캠페인 구분, 내부 관리 번호 등 자유롭게 활용 가능. 최대 10개 필드, 키 30자/값 100자, 모두 문자열
hintobject발송 시 참고할 힌트 정보
allowDuplicatesbooleantrue이면 같은 수신번호에 동일한 내용의 메시지를 중복으로 추가 가능. 기본값: false

Structures

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