하위 조직 생성
인증된 상위 조직 아래에 하위 조직을 생성합니다. 상위 조직의 API 키로만 호출할 수 있습니다. 선택 설정(webhook_url, webhook_event_subscriptions, billing_invoice_recipient_emails)은 값을 주면 적용되고, 생략하면 기본값을 따릅니다. 청구서 수신 이메일을 지정하지 않으면 상위 조직의 설정을 물려받습니다.
Authorizations
조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.
Body
생성할 하위 조직 정보입니다.
하위 조직 생성 요청입니다. is_main은 생략하거나 false만 보낼 수 있으며(true면 400), 상위 조직·결제 방식·오너는 서버가 정합니다. 선택 설정은 값을 주면 적용되고 생략하면 기본값을 따릅니다.
조직 이름입니다. 앞뒤 공백은 제거됩니다.
1 - 255상위 조직 여부입니다. 이 API는 하위 조직만 생성하므로 false만 보낼 수 있으며(true면 400), 생략 시 false입니다.
webhook 수신 URL입니다. https URL만 허용하며, null·빈 문자열·생략 시 미설정으로 생성됩니다.
2048구독할 webhook 이벤트 타입 목록입니다. 현재 sms_received만 구독 대상이며, 통화 관련 이벤트는 구독과 무관하게 항상 발송됩니다. 중복은 제거되고, null·생략 시 빈 목록으로 생성됩니다.
청구서 안내 수신 이메일 목록입니다. 소문자로 정규화되며 중복은 거부됩니다. null·생략·빈 배열이면 상위 조직 설정을 상속합니다(상위 조직 수신 이메일 → 상위 조직 오너 이메일 → 둘 다 없으면 빈 목록).
Response
성공 응답
조직 ID입니다.
조직 이름
상위 조직 여부입니다(false면 하위 조직).
webhook payload 버전 (v1/v2)
구독 중인 webhook 이벤트 타입 목록입니다.
리소스 생성 시각입니다. unix milliseconds 형식입니다.
상위 조직 ID입니다. 하위 조직만 값이 있고 상위 조직은 null입니다.
webhook 수신 URL
청구서 안내 수신 이메일입니다.
구독 정보입니다. 상위 조직만 포함되고 하위 조직은 null입니다.