---
title: "POST /api/video/v2/incoming_webhooks/{id}/receive"
method: POST
path: "/api/video/v2/incoming_webhooks/{id}/receive"
tags: ["Video/VideoIncomingWebhookReceive"]
---

# POST /api/video/v2/incoming_webhooks/{id}/receive

`POST /api/video/v2/incoming_webhooks/{id}/receive`

Incoming Webhook (会議履歴) 用のエンドポイントです。会議履歴を生成し、動画/音声ファイルをアップロードするためのエンドポイントを返却します。
※ご契約いただいた一部のお客様のみご利用いただけます。詳細についてはお問い合わせください。

## Path parameters

- `id` string, required

## Request body

- VideoIncomingWebhookReceive
  - `video_data` object, required — 会議履歴データ
    - `title` string, required — 会議のタイトル
    - `file_type` 'mp4' | 'm4a' | 'wav' | 'mp3', required — mp4、m4a、wav、mp3。
    - `host` string, uuid, required — MiiTel Admin から取得した id。
    - `starts_at` string, date-time, required — 会議の開始時間 Timezone UTC ISO 8601形式
    - `ends_at` string, date-time, required — 会議の終了時間 Timezone UTC ISO 8601形式
    - `external_id` string — 外部システムの ID を保持します。Outgoing Webhook で送信され、外部システムとの連携に使用します。
    - `number_of_participants` integer — 会議の参加者数
    - `channel_type` 'MONAURAL' | 'STEREO' — - 音声ファイルのチャンネル種別 - 未設定の場合は STEREO
    - `tags` object[]
      - `value` string, required — - タグ名 - 最大512文字
    - `participants` object[]
      - `name` string, nullable, required — 参加者名。
      - `miitel_user_id` string, uuid, required — VIDEO_INCOMING_WEBHOOK_RECEIVE_MIITEL_USER_ID
      - `stereo_lr` 'left' | 'right' — 'left' ... participant の音声が左チャンネルであることを示す 'right' ... participant の音声が右チャンネルであることを示す
  - `upload_data` object — - url に動画/音声ファイルを PUT すると解析が開始 - video_id: 会議履歴のID - video_detail_id: 会議履歴の詳細情報のID
    - `url` string
    - `external_id` string
    - `video_id` string
    - `video_detail_id` string
    - `tmp_file_id` string

## Response `201`

- VideoIncomingWebhookReceive
  - `video_data` object, required — 会議履歴データ
    - `title` string, required — 会議のタイトル
    - `file_type` 'mp4' | 'm4a' | 'wav' | 'mp3', required — mp4、m4a、wav、mp3。
    - `host` string, uuid, required — MiiTel Admin から取得した id。
    - `starts_at` string, date-time, required — 会議の開始時間 Timezone UTC ISO 8601形式
    - `ends_at` string, date-time, required — 会議の終了時間 Timezone UTC ISO 8601形式
    - `external_id` string — 外部システムの ID を保持します。Outgoing Webhook で送信され、外部システムとの連携に使用します。
    - `number_of_participants` integer — 会議の参加者数
    - `channel_type` 'MONAURAL' | 'STEREO' — - 音声ファイルのチャンネル種別 - 未設定の場合は STEREO
    - `tags` object[]
      - `value` string, required — - タグ名 - 最大512文字
    - `participants` object[]
      - `name` string, nullable, required — 参加者名。
      - `miitel_user_id` string, uuid, required — VIDEO_INCOMING_WEBHOOK_RECEIVE_MIITEL_USER_ID
      - `stereo_lr` 'left' | 'right' — 'left' ... participant の音声が左チャンネルであることを示す 'right' ... participant の音声が右チャンネルであることを示す
  - `upload_data` object — - url に動画/音声ファイルを PUT すると解析が開始 - video_id: 会議履歴のID - video_detail_id: 会議履歴の詳細情報のID
    - `url` string
    - `external_id` string
    - `video_id` string
    - `video_detail_id` string
    - `tmp_file_id` string

---

[API](https://skmtc.net/miitel/apis/miitel-account-api.md) · [All operations](https://skmtc.net/miitel/apis/miitel-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/miitel/miitel-account-api/revisions/19b9b4ab780a/schema)