API

예정된 활동 조회

작성일 2026.03.24 | 수정일 2026.04.14

GET/crm-core/v1/activities/record/{recordId}/scheduled

특정 레코드의 예정된 활동 목록을 조회합니다. scheduledAt 또는 dueDate가 설정된 활동만 반환합니다.

Path Params| Name | Type | Required | Description |

| ------ | ------ | ------ | ------ | | recordId | string | * | 레코드 고유 아이디. "CALENDAR"를 입력하면 일반 일정만 조회됩니다. | Query

Name	Type	Required	Description
limit	number		조회 개수 제한 (기본값 20)

Response|

응답은 활동 객체 배열입니다.

Name	Type	Description
activityId	string	활동 고유 아이디
accountId	string	계정 고유 아이디
recordId	string	연결된 레코드 고유 아이디. "CALENDAR"인 경우 일반 일정입니다.
activityType	string	활동 유형 (CALL, EMAIL, MEETING, NOTE, TASK, MESSAGE, OTHER)
subject	string	활동 제목
description	string	활동 내용
assignedMemberId	string	담당자 멤버 ID (단수, 하위 호환)
assignedMemberIds	Array\	담당자 목록
scheduledAt	date	예정 일시
dueDate	date	마감 일시
completedAt	date	완료 일시
outcome	string	활동 결과 상태
durationMinutes	number	소요 시간(분)
metadata	Object	메타데이터
ownerId	string	활동 소유자 멤버 ID
visibility	string	활동 공개 범위 (PRIVATE 또는 PUBLIC)
dateCreated	date	최초 생성 날짜
dateUpdated	date	최근 수정 날짜

Structure

json Response Structure
[
  {
    "activityId": "ACT20260324090000ABCDEFGHIJKLMNO",
    "accountId": "24010100001234",
    "recordId": "REC20260324090000ABCDEFGHIJKLMNO",
    "activityType": "MEETING",
    "subject": "고객 미팅",
    "description": "설명 텍스트",
    "assignedMemberId": "ID_SAMPLE_12345",
    "assignedMemberIds": ["ID_SAMPLE_12345"],
    "scheduledAt": "2026-03-24T09:00:00.000Z",
    "dueDate": "2026-03-24T18:00:00.000Z",
    "completedAt": null,
    "outcome": "PENDING",
    "durationMinutes": 30,
    "metadata": {},
    "ownerId": "MEM20260324090000ABCDEFGHIJKLMNO",
    "visibility": "PRIVATE",
    "dateCreated": "2026-03-24T09:00:00.000Z",
    "dateUpdated": "2026-03-24T09:00:00.000Z"
  }
]