イベントを作成

POST/manage/events

イベントを DRAFT 状態で作成します。作成者は自動的に ADMIN スタッフとして登録されます。権限チェックはなく、ログイン中のユーザーであれば作成できます。主催者(EventOrganizer)は organizers で指定します。

認証要ログイン

リクエストボディ

titlestring必須

イベント名(必須)。文字数制限なし。

descriptionstring

説明(Markdown)。文字数制限なし。

languagesobject

多言語のタイトル・説明。

eventTypestring

ONSITE / ONLINE / HYBRID のいずれか(作成時は必須)

timezonestring

IANA タイムゾーン(例: Asia/Tokyo)

schedulesobject[]

開催日ごとの日程の配列。各要素は date(YYYY-MM-DD)・startTime / endTime(HH:mm)を持ち、doorTime(開場時刻)は任意。時刻はイベントの timezone で解釈される。

locationobject

開催場所。

onlineUrl / onlineDescriptionstring

オンライン開催の URL(有効な URL 形式)と説明(200 文字以内)

enabledTickets / enabledSideEventsboolean

チケット販売・サイドイベントの有効化フラグ。イベント管理者が変更できるのはこの 2 つのみ。

slugstring

3〜200 文字。半角英小文字・数字・ハイフン・アンダースコアのみ(^[a-z0-9-_]+$)。重複不可。

thumbnailUrl / mainImageUrlstring

画像 URL。有効な URL 形式であること。アップロード系エンドポイントが返した URL を指定する。

customStyle / customNavigationobject

カスタムスタイル・ナビゲーション。

organizerContactobject

主催者の連絡先。

tagsstring[]

タグ名の配列。

organizersobject[]

主催者(EventOrganizer)。communityId または userId を指定。

オブジェクトの構造

schedules

開催日ごとの日程。日付と時刻は分けて指定し、時刻はイベントの timezone で解釈されます。

datestring必須

開催日。YYYY-MM-DD 形式。

doorTimestring

開場時刻。HH:mm 形式。

startTimestring必須

開始時刻。HH:mm 形式。

endTimestring必須

終了時刻。HH:mm 形式。

[
  { "date": "2026-09-01", "doorTime": "09:30", "startTime": "10:00", "endTime": "18:00" }
]

location

会場情報。単一のオブジェクト、または複数会場を表すオブジェクトの配列を指定できます。

name / titlestring

会場名・表示ラベル。

displayTextstring

表示用のテキスト。

placeIdstring

Google Places の場所 ID。

zipCode / country / countryCode / state / city / address / buildingstring

住所の各要素。

geoobject

座標(lat / lng)

websiteUrl / telstring

会場のウェブサイト・電話番号。

descriptionstring

会場の補足説明。

primaryboolean

複数会場のうち主要な会場か。

{
  "name": "4S Hall",
  "displayText": "東京都渋谷区...",
  "countryCode": "JP",
  "geo": { "lat": 35.6595, "lng": 139.7005 },
  "primary": true
}

languages

言語コードをキーに、その言語で表示する title / description を指定します。指定した言語のみ上書きされ、未指定の言語は既定のフィールドが使われます。

<lang>object

言語コード(ja / en など)

<lang>.titlestring

その言語で表示するタイトル。

<lang>.descriptionstring

その言語で表示する説明。

{
  "ja": { "title": "オープニング基調講演", "description": "..." },
  "en": { "title": "Opening Keynote", "description": "..." }
}

contact / organizerContact

連絡先。オブジェクトの配列(最大 10 件)で指定します。後方互換のため単一オブジェクトも受け付けます。

labelstring

表示ラベル(例: お問い合わせ窓口)

emailstring

メールアドレス。

urlstring

問い合わせフォームなどの URL。

x / instagram / facebook / youtubestring

公式 SNS。

languagesobject

言語別ラベル({ [lang]: { label } })

[
  {
    "label": "お問い合わせ",
    "email": "contact@example.com",
    "languages": { "en": { "label": "Contact" } }
  }
]

補足

enabledMeetings(ミーティング)/ enabledChat(チャット)/ enabledReferralTree(リファラルツリー・招待機能)/ enabledConferenceMode(カンファレンスモード)は、プラットフォーム運営用の admin API でのみ有効化できます。このエンドポイントのリクエストに含めても無視され、作成時は常に false になります。イベント管理者が変更できる機能フラグは enabledTickets(チケット販売)と enabledSideEvents(サイドイベント)のみです。現在の値は GET /manage/events/:eventId のレスポンスで確認できます。

リクエスト
curl https://api.4s.link/manage/events \
-X POST \
-H "Authorization: Bearer 4s_at_..." \
-H "Content-Type: application/json" \
-d '{
"title": "4S Tech Conference 2026",
"eventType": "HYBRID",
"timezone": "Asia/Tokyo",
"schedules": [
{ "date": "2026-09-01", "startTime": "10:00", "endTime": "18:00" }
]
}'
レスポンス例
{
"id": "e1f2a3b4-...",
"slug": "tech-conf-2026",
"title": "4S Tech Conference 2026",
"description": "...",
"state": "DRAFT",
"eventType": "HYBRID",
"timezone": "Asia/Tokyo",
"schedules": [
{ "date": "2026-09-01", "doorTime": "09:30", "startTime": "10:00", "endTime": "18:00" }
],
"location": { "displayText": "Tokyo, Japan" },
"thumbnailUrl": "https://.../thumb.png",
"organizers": [
{ "id": "eo1a2b3-...", "communityId": "c1a2b3c4-...", "userId": null }
],
"tags": []
}