API

서브계정 생성

작성일 2026.03.21 | 수정일 2026.03.21

POST/appstore/v2/me/apps/:appId/subaccounts

Parameters

appId*— SITE 앱 ID (deductFromMaster=true 필수)

마이사이트 앱에 서브계정을 등록합니다. 앱당 동일 계정은 1개만 등록 가능합니다.

Body Params

Name	Type	Required	Description
accountId	string	*	등록할 서브계정 ID
customField1	object		커스텀 필드 1
name	string\|null		필드 이름
value	string\|null		필드 값 (최대 250자)
customField2	object		커스텀 필드 2
name	string\|null		필드 이름
value	string\|null		필드 값 (최대 250자)
customField3	object		커스텀 필드 3
name	string\|null		필드 이름
value	string\|null		필드 값 (최대 250자)
customField4	object		커스텀 필드 4
name	string\|null		필드 이름
value	string\|null		필드 값 (최대 250자)
customField5	object		커스텀 필드 5
name	string\|null		필드 이름
value	string\|null		필드 값 (최대 250자)

Response

Name	Type	Required	Description
handleKey	string	*	서브계정 고유 키 (접두사: AP02SA, 자동 생성)
appId	string	*	앱 ID
accountId	string	*	서브계정 ID
customField1	object\|null		커스텀 필드 1
name	string\|null		필드 이름
value	string\|null		필드 값 (최대 250자)
customField2	object\|null		커스텀 필드 2
name	string\|null		필드 이름
value	string\|null		필드 값 (최대 250자)
customField3	object\|null		커스텀 필드 3
name	string\|null		필드 이름
value	string\|null		필드 값 (최대 250자)
customField4	object\|null		커스텀 필드 4
name	string\|null		필드 이름
value	string\|null		필드 값 (최대 250자)
customField5	object\|null		커스텀 필드 5
name	string\|null		필드 이름
value	string\|null		필드 값 (최대 250자)
dateCreated	string	*	생성일시 (ISO 8601)
dateUpdated	string	*	수정일시 (ISO 8601)

Structure

Request

{
  "accountId": "12345678901234",
  "customField1": {
    "name": "부서",
    "value": "마케팅팀"
  },
  "customField2": {
    "name": "담당자",
    "value": "홍길동"
  },
  "customField3": null,
  "customField4": null,
  "customField5": null
}

Response

{
  "handleKey": "AP02SA_abc12345678901234567890",
  "appId": "aBcDeFgHiJkL",
  "accountId": "12345678901234",
  "customField1": {
    "name": "부서",
    "value": "마케팅팀"
  },
  "customField2": {
    "name": "담당자",
    "value": "홍길동"
  },
  "customField3": null,
  "customField4": null,
  "customField5": null,
  "dateCreated": "2024-01-15T09:00:00.000Z",
  "dateUpdated": "2024-01-15T09:00:00.000Z"
}