Skip to main content
POST
/
organizations
하위 조직 생성
curl --request POST \
  --url https://client-api.tryvox.co/v3/organizations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "is_main": false,
  "webhook_url": "<string>",
  "webhook_event_subscriptions": [
    "<string>"
  ],
  "billing_invoice_recipient_emails": [
    "<string>"
  ]
}
'
{
  "id": "<string>",
  "name": "<string>",
  "is_main": true,
  "webhook_version": "<string>",
  "webhook_event_subscriptions": [
    "<string>"
  ],
  "created_at": 123,
  "parent_organization_id": "<string>",
  "webhook_url": "<string>",
  "billing_invoice_recipient_emails": [
    "<string>"
  ],
  "subscription": {
    "display_name": "<string>",
    "plan_sms_send_text_fee": 123,
    "plan_sms_send_mms_fee": 123,
    "plan_sms_recv_fee": 123,
    "plan_concurrent_call_limit": 123,
    "plan_hourly_call_limit": 123,
    "plan_daily_call_limit": 123
  }
}

Authorizations

Authorization
string
header
required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Body

application/json

생성할 하위 조직 정보입니다.

하위 조직 생성 요청입니다. is_main은 생략하거나 false만 보낼 수 있으며(true면 400), 상위 조직·결제 방식·오너는 서버가 정합니다. 선택 설정은 값을 주면 적용되고 생략하면 기본값을 따릅니다.

name
string
required

조직 이름입니다. 앞뒤 공백은 제거됩니다.

Required string length: 1 - 255
is_main
boolean
default:false

상위 조직 여부입니다. 이 API는 하위 조직만 생성하므로 false만 보낼 수 있으며(true면 400), 생략 시 false입니다.

webhook_url
string | null

webhook 수신 URL입니다. https URL만 허용하며, null·빈 문자열·생략 시 미설정으로 생성됩니다.

Maximum string length: 2048
webhook_event_subscriptions
string[] | null

구독할 webhook 이벤트 타입 목록입니다. 현재 sms_received만 구독 대상이며, 통화 관련 이벤트는 구독과 무관하게 항상 발송됩니다. 중복은 제거되고, null·생략 시 빈 목록으로 생성됩니다.

billing_invoice_recipient_emails
string[] | null

청구서 안내 수신 이메일 목록입니다. 소문자로 정규화되며 중복은 거부됩니다. null·생략·빈 배열이면 상위 조직 설정을 상속합니다(상위 조직 수신 이메일 → 상위 조직 오너 이메일 → 둘 다 없으면 빈 목록).

Response

성공 응답

id
string
required

조직 ID입니다.

name
string
required

조직 이름

is_main
boolean
required

상위 조직 여부입니다(false면 하위 조직).

webhook_version
string
required

webhook payload 버전 (v1/v2)

webhook_event_subscriptions
string[]
required

구독 중인 webhook 이벤트 타입 목록입니다.

created_at
integer
required

리소스 생성 시각입니다. unix milliseconds 형식입니다.

parent_organization_id
string | null

상위 조직 ID입니다. 하위 조직만 값이 있고 상위 조직은 null입니다.

webhook_url
string | null

webhook 수신 URL

billing_invoice_recipient_emails
string[] | null

청구서 안내 수신 이메일입니다.

subscription
SubscriptionView · object

구독 정보입니다. 상위 조직만 포함되고 하위 조직은 null입니다.