【重要】freee人事労務API 従業員作成/更新API 仕様変更のお知らせ

■ 概要

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

従業員の作成・更新APIにおいて、締め日支払い日グループ名パラメータの文字数制限を15文字から20文字へ緩和します。

■ 変更内容

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

対象API:api/v1/employees(POST / PUT)

変更種別:Non-Breaking Change

変更内容:

従業員作成/更新時に指定可能な「締め日支払い日グループ名」パラメータの最大文字数制限を、従来の15文字から20文字へ拡張します。

変更理由:

締め日支払い日グループ名未指定時のデフォルト名変更に伴い、登録可能な文字数を拡張するため。

■ 変更スケジュール

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

アナウンス日:2026/11/17

変更リリース日:2026/11/23

旧バージョン廃止予定日:該当なし(後方互換性のある変更のため)

■ 対応方法

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

本変更はパラメータの上限緩和(後方互換性あり)のため、既存の連携アプリ側での必須の対応はございません。
20文字までの締め日支払い日グループ名を取り扱う場合のみ、必要に応じてクライアント側のバリデーション設定等の見直しをご検討ください。

■ 変更後のAPI仕様

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

対象エンドポイント:

リクエスト変更詳細:

  • Request bodyのフォーマット・構造自体に変更はありません。
  • 対象パラメータの文字数制約を変更します:
    • パラメータ名:company_reference_date_rule_name
    • 変更前:maxLength: 15
    • 変更後:maxLength: 20