thumbnail

HERP Hire API で「職種の追加・編集」「メールテンプレートの取得・追加・編集」が可能になりました🎉

2026/10/9 API 経由で職種の追加・編集と、応募者メールテンプレート・エージェントメールテンプレートの取得・追加・編集ができるようになりました!

HERP Hire API に、職種とメールテンプレートを扱うAPIを追加しました。外部のマスタやスプレッドシートと連携し、職種情報や定型文の登録・更新をまとめて行えます。

  • 職種を追加できます(POST /v1/requisitions)。

    • 職種名のみでも追加することが可能です

  • 職種を編集できます(PATCH /v1/requisitions/{requisitionId})。

    • こちらは指定した項目だけ更新されます

    • 仕事概要、スキル、条件、公開状況、オペレーション担当、アーカイブ可否に加え、エージェント用追記事項(募集背景、ターゲット、採用人数、選考フロー、募集期間、待遇、優先度)を更新することができます

  • 職種一覧の取得(GET /v1/requisitions)でも、エージェント用追記事項を返します

  • 応募者メールテンプレートの一覧取得・追加・編集ができます(GET / POST /v1/candidacy-mail-templates、PATCH /v1/candidacy-mail-templates/{candidacyMailTemplateId})

  • エージェントメールテンプレートの一覧取得・追加・編集ができます(GET / POST /v1/agent-mail-templates、PATCH /v1/agent-mail-templates/{agentMailTemplateId})

  • 取得・登録・更新できる項目は、テンプレートタイトル、件名、本文です

  • 求人管理において、会社所在地や法令対応で複数求人の内容を一括で変更したい場合に、現状の求人譲歩を取得したうえで変更内容を更新する

  • 応募者向け・エージェント向けの定型文について、ヘッダーやフッターの一律差し替えを実施したい場合に、HERP Hire のメールテンプレートを更新する

  • 有料プランかつ HERP Hire API の利用申請・利用規約への同意が必要です(こちらは既存の HERP Hire API と同様です。一度同意されていれば、追加での同意は不要です。)

  • 職種の追加・編集には、API キー発行時に all / write / requisition:all / requisition:write のいずれかを選択してください

  • メールテンプレートに関するAPIを利用するためには、APIのスコープを以下に変更・あるいは以下を含む必要があります。

    • 応募者メールテンプレート: candidacy-mail-template:read / write

    • エージェントメールテンプレートは agent-mail-template:read / write

  • 発行済みの API キーには新しいスコープは含まれません。必要な場合は API キーを発行し直してください