manaable REST API
What's manaableAbout Us
What's manaableAbout Us
  1. Members
  • Introduction
  • イントロダクション
  • API v3
    • Members
      • Get Members
      • Get Member by ID
    • Teams
      • Get Teams
      • Get Team by ID
  • API v2
    • Trainings
      • List trainings / 研修一覧取得
      • Count trainings / 研修件数取得
      • Get training custom field definitions / 研修カスタムフィールド定義取得
      • Get training by ID / 研修詳細取得
      • Update training / 研修情報更新
      • Delete training / 研修削除
    • Applicants
      • List applicants / 申込者一覧取得
      • Bulk create/update applicants (upsert) / 申込者一括作成/更新 (upsert)
      • Count applicants / 申込者件数取得
      • Bulk update applicant status / 申込ステータス一括更新
    • Members
      • List members / メンバー一覧取得
        GET
      • Bulk create/update members / メンバー一括作成/更新
        PUT
      • Get member custom field definitions / メンバーカスタムフィールド定義取得
        GET
      • Get member by ID / メンバー詳細取得
        GET
      • Update member / メンバー情報更新
        PATCH
      • Delete member / メンバー削除
        DELETE
      • Update member password / メンバーパスワード更新
        PATCH
    • Teams
      • List teams / チーム一覧取得
      • Bulk create/update teams / チーム一括作成/更新
      • Get team custom field definitions / チームカスタムフィールド定義取得
      • Get team by ID / チーム詳細取得
      • Update team / チーム情報更新
      • Delete team / チーム削除
  • API v1
    • Get member groups
      GET
  • Schemas
    • Schemas
      • ContactForm
      • Exam
      • ExamResult
      • Lesson
      • LessonAttempt
      • Notification
      • Settings
      • StaticFieldsSetting
      • TeamMember
      • TrainingQuestionnaireResponse
      • TrainingQuestionnaireTemplate
      • TrainingRegTemplate
      • TrainingTaskResponse
      • TrainingTaskTemplate
      • UnsubscriptionQuestionnaire
    • Training
    • Member
    • Team
    • TrainingApplication
    • CustomFieldMaster
    • CustomFieldData
    • ErrorResponse
    • SuccessResponse
    • ValidationErrorResponse
  1. Members

Bulk create/update members / メンバー一括作成/更新

PUT
/members
Creates or updates members in bulk.
メンバーを一括で作成または更新する。
Primary key selection / プライマリキー選択: Use the X-MBAPIv2-Primary-Key header to specify the upsert key.
X-MBAPIv2-Primary-Key ヘッダーで upsert のキーを指定する。
id (default): upsert based on members.id / members.id を基準に upsert
ext_id: upsert based on members.ext_id / members.ext_id を基準に upsert
Team data / チームデータ: Use team_id_1–team_id_3 and team_leader_1–team_leader_3 fields to sync team memberships (sync).
team_id_1〜team_id_3, team_leader_1〜team_leader_3 フィールドでメンバーのチーム所属を同期する (sync)。
Custom fields / カスタムフィールド: Fields not in the member table columns are saved as custom fields.
member テーブルのカラム以外のフィールドはカスタムフィールドとして保存される。
Constraints / 制約:
email must be unique. Email cannot be changed when updating an existing member (enforced in code) / email は一意。既存メンバーの更新時はメールアドレスを変更しない (コードで保護)
Password is not changed on update (enforced in code). Only hashed and saved on creation / password は更新時に変更しない (コードで保護)。新規作成時のみハッシュ化して保存
is_active and team membership cannot be changed for restricted team leaders (those with payment dues) / 制限付きチームリーダー (payment dues あり) の is_active, team 所属は変更不可
Background job / バックグラウンドジョブ: Member group recalculation runs asynchronously as the ProcessMemberGroupAssignment job.
メンバーグループ再計算は ProcessMemberGroupAssignment ジョブとして非同期実行。
Validation / バリデーション: is_required changes dynamically based on StaticFieldsSetting configuration.
StaticFieldsSetting の設定に基づき is_required が動的に変わる。

Request

Authorization
API Key
Add parameter in header
api-key
Example:
api-key: ********************
or
Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Success / 成功
Bodyapplication/json

🟠400
🟠403
🟠422
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT '/members' \
--header 'X-MBAPIv2-Primary-Key;' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "members": [
        {
            "id": 0,
            "ext_id": "string",
            "email": "user@example.com",
            "password": "stringst",
            "first_name": "string",
            "last_name": "string",
            "kana_first_name": "string",
            "kana_last_name": "string",
            "gender": "string",
            "d_o_b": "2019-08-24",
            "postal_code": "string",
            "prefecture": "string",
            "municipality": "string",
            "town": "string",
            "street_address": "string",
            "building": "string",
            "phone_number": "string",
            "admission_status": "string",
            "is_active": "ACTIVE",
            "team_id_1": "string",
            "team_id_2": "string",
            "team_id_3": "string",
            "team_leader_1": 0,
            "team_leader_2": 0,
            "team_leader_3": 0
        }
    ]
}'
Response Response Example
200 - Success
{
    "code": 0,
    "message": "Members updated successfully",
    "data": null
}
Modified at 2026-06-18 02:44:25
Previous
List members / メンバー一覧取得
Next
Get member custom field definitions / メンバーカスタムフィールド定義取得
Built with