API

활동 생성

작성일 2026.03.24 | 수정일 2026.03.25

POST/crm-core/v1/activities

새로운 활동을 생성합니다. MEMBER 이상 권한이 필요합니다.

Body Params

Name	Type	Required	Description
recordId	string	*	레코드 ID. "CALENDAR"를 입력하면 특정 레코드에 연결되지 않는 일반 일정으로 추가됩니다.
activityType	string	*	활동 유형 - CALL, EMAIL, MEETING, NOTE, TASK, MESSAGE, OTHER 중 하나
subject	string	*	활동 제목
description	string		활동 설명
entityId	string		개체 ID
relatedRecordIds	Array<String>		관련 레코드 ID 목록
scheduledAt	date		예정 일시 (ISO 8601)
dueDate	date		마감 일시 (ISO 8601)
assignedMemberIds	Array<String>		담당자 멤버 ID 목록
durationMinutes	number		소요 시간(분)
metadata	Object		추가 메타데이터
ownerId	string		활동 소유자 멤버 ID. 미입력 시 현재 멤버 ID로 자동 설정
visibility	string		활동 공개 범위 (PRIVATE(기본값) 또는 PUBLIC)

Response

Name	Type	Required	Description
activityId	string	*	활동 고유 ID
accountId	string	*	계정 고유 ID
recordId	string	*	레코드 ID. "CALENDAR"인 경우 일반 일정입니다.
activityType	string	*	활동 유형
subject	string	*	활동 제목
description	string		활동 설명
scheduledAt	date		예정 일시
dueDate	date		마감 일시
assignedMemberIds	Array<String>		담당자 목록
durationMinutes	number		소요 시간
metadata	Object		메타데이터
ownerId	string	*	활동 소유자 멤버 ID
visibility	string	*	활동 공개 범위 (PRIVATE 또는 PUBLIC)
dateCreated	date	*	최초 생성 날짜
dateUpdated	date	*	최근 수정 날짜

Structure

Request Structure

{
  "recordId": "REC20260324090000ABCDEFGHIJKLMNO",
  "activityType": "MEETING",
  "subject": "고객 미팅",
  "description": "설명 텍스트",
  "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
  "relatedRecordIds": [
    "샘플값"
  ],
  "scheduledAt": "2026-03-24T09:00:00.000Z",
  "dueDate": "2026-03-24T09:00:00.000Z",
  "assignedMemberIds": [
    "샘플값"
  ],
  "durationMinutes": 30,
  "metadata": {
    "key": "value"
  },
  "ownerId": "MEM20260324090000ABCDEFGHIJKLMNO",
  "visibility": "PRIVATE"
}

Response Structure

{
  "activityId": "ACT20260324090000ABCDEFGHIJKLMNO",
  "accountId": "24010100001234",
  "recordId": "REC20260324090000ABCDEFGHIJKLMNO",
  "activityType": "MEETING",
  "subject": "고객 미팅",
  "description": "설명 텍스트",
  "scheduledAt": "2026-03-24T09:00:00.000Z",
  "dueDate": "2026-03-24T09:00:00.000Z",
  "assignedMemberIds": [
    "샘플값"
  ],
  "durationMinutes": 30,
  "metadata": {
    "key": "value"
  },
  "ownerId": "MEM20260324090000ABCDEFGHIJKLMNO",
  "visibility": "PRIVATE",
  "dateCreated": "2026-03-24T09:00:00.000Z",
  "dateUpdated": "2026-03-24T09:00:00.000Z"
}