ホーム/CRM（顧客管理）/活動

活動（Activities）

案件や連絡先に紐づく活動（メモ・電話・メール等）を記録します。

エンドポイント

GET	/api/v1/crm/activities	活動一覧を取得
POST	/api/v1/crm/activities	活動を作成
PATCH	/api/v1/crm/activities/{id}	活動を更新
DELETE	/api/v1/crm/activities/{id}	活動を削除

GET/api/v1/crm/activities

活動一覧を取得

組織内の活動をページネーション付きで取得します。活動タイプ・案件・連絡先での絞り込みに対応しています。

認証が必要です— セッション Cookie または Bearer トークンを含めてください

クエリパラメータ

名前	型	必須	説明
limit	integer	任意	1ページあたりの件数（デフォルト: 50、最大: 200）
offset	integer	任意	スキップする件数
type	string	任意	活動タイプで絞り込み（note, call, email, meeting）
deal_id	string	任意	案件 ID で絞り込み
contact_id	string	任意	連絡先 ID で絞り込み

レスポンスフィールド

名前	型	必須	説明
	Activity[]	任意	活動の配列
total	number	任意	総件数
limit	number	任意	1ページあたりの件数
offset	number	任意	スキップした件数

コード例

curl "https://api.blueai.jp/api/v1/crm/activities" \
  -H "Cookie: better-auth.session_token=<token>"

レスポンス例

{
  "items": [
    {
      "id": "act_cccccccccccccccccccccccccccccccc",
      "type": "note",
      "content": "初回ヒアリング実施。予算感は1000万円前後。",
      "deal_id": "deal_11111111111111111111111111111111",
      "contact_id": null,
      "created_by": "usr_99999999999999999999999999999999",
      "created_at": "2026-02-10T14:30:00Z"
    }
  ],
  "total": 12,
  "limit": 50,
  "offset": 0
}

POST/api/v1/crm/activities

活動を作成

案件または連絡先に紐づく活動を記録します。タイプにはメモ・電話・メール・ミーティング等を指定できます。

認証が必要です— セッション Cookie または Bearer トークンを含めてください

リクエストボディ

名前	型	必須	説明
type	string	必須	活動タイプ（note, call, email, meeting）
content	string	必須	活動内容
deal_id	string	任意	関連する案件 ID
contact_id	string	任意	関連する連絡先 ID

レスポンスフィールド

名前	型	必須	説明
	Activity	任意	作成された活動

コード例

curl -X POST "https://api.blueai.jp/api/v1/crm/activities" \
  -H "Cookie: better-auth.session_token=<token>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "note",
  "content": "初回ヒアリング実施。予算感は1000万円前後。",
  "deal_id": "deal_11111111111111111111111111111111"
}'

レスポンス例

{
  "activity": {
    "id": "act_cccccccccccccccccccccccccccccccc",
    "type": "note",
    "content": "初回ヒアリング実施。予算感は1000万円前後。",
    "deal_id": "deal_11111111111111111111111111111111",
    "contact_id": null,
    "created_by": "usr_99999999999999999999999999999999",
    "created_at": "2026-02-10T14:30:00Z"
  }
}

PATCH/api/v1/crm/activities/{id}

活動を更新

指定した活動の内容を更新します。送信したフィールドのみ更新されます。

認証が必要です— セッション Cookie または Bearer トークンを含めてください

パスパラメータ

名前	型	必須	説明
id	string	必須	活動 ID

リクエストボディ

名前	型	必須	説明
type	string	任意	活動タイプ（note, call, email, meeting）
content	string	任意	活動内容
deal_id	string	任意	関連する案件 ID
contact_id	string	任意	関連する連絡先 ID

レスポンスフィールド

名前	型	必須	説明
	Activity	任意	更新後の活動

コード例

curl -X PATCH "https://api.blueai.jp/api/v1/crm/activities/act_123e4567e89b12d3a456426614174000" \
  -H "Cookie: better-auth.session_token=<token>" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "初回ヒアリング実施。予算感は1500万円に上方修正。"
}'

レスポンス例

{
  "activity": {
    "id": "act_cccccccccccccccccccccccccccccccc",
    "type": "note",
    "content": "初回ヒアリング実施。予算感は1500万円に上方修正。",
    "deal_id": "deal_11111111111111111111111111111111",
    "contact_id": null,
    "created_by": "usr_99999999999999999999999999999999",
    "created_at": "2026-02-10T14:30:00Z"
  }
}

DELETE/api/v1/crm/activities/{id}

活動を削除

指定した活動を削除します。

認証が必要です— セッション Cookie または Bearer トークンを含めてください

パスパラメータ

名前	型	必須	説明
id	string	必須	活動 ID

レスポンスフィールド

名前	型	必須	説明
success	boolean	任意	削除成功フラグ

コード例

curl -X DELETE "https://api.blueai.jp/api/v1/crm/activities/act_123e4567e89b12d3a456426614174000" \
  -H "Cookie: better-auth.session_token=<token>"

レスポンス例

{
  "success": true
}