リリース日：2026年8月19日
外部システムとの連携にご利用いただける新しい API「Mazrica Open API v2」の提供を開始しました。v1 の仕様変更・アップデートではなく、v1 とは別系統の新規 API です。
※ 現行の v1 と同様、Growth プラン以上（または API オプションを個別にご契約のお客様）でご利用いただけます。
現在 v1 をご利用中のお客様へ
v1 の API キーや連携設定に変更はありませんので、引き続きそのままご利用いただけます。
また、原則として今後のAPI機能追加はAPI v2を対象に行う予定となりますため、
新規の連携構築や新規APIのご利用、より高いセキュリティ・AI 連携をご検討の場合は v2 のご利用をおすすめします。
API v2 でできること
AI エージェントや MCP（Model Context Protocol）からの利用を想定し、新たな基盤で構築した API です。
有効期限付きの API キーを発行できます
個人 API キーを使うと、発行したご本人の権限の範囲内でのみデータを操作できます
リクエストの上限を v1 より引き上げています（5 リクエスト/秒。1 日あたり個人 API キー 50,000／チーム API キー 200,000 リクエスト）
現在ご利用いただけるエンドポイントは API リファレンスをご確認ください。
今後の提供予定
現時点では、取引先・案件・コンタクト・アクション・案件コンタクトの操作に関する API をご利用いただけます。
2026/08/24 〜 10/14（週次リリース）：ユーザー・ロールなどの設定関連 API、カスタムオブジェクト、監査ログ取得
2026/10 以降：MCP サーバーの公開（2026 年内を予定）
※ 提供時期は変更になる場合があります。
移行方法
1. v2 用の API キーを発行する
API キーは 2 種類あります。システム間の連携にはチーム API キーを推奨します。
| 発行場所 | 動作する権限 |
個人 API キー（PAT） | 設定 ＞ 個人設定 ＞「API 利用」 | 発行したご本人の権限。 ロールやプロファイルで参照できないデータは操作できません |
チーム API キー（TAT） | 設定 ＞ API 利用 ＞「（新）API 利用」 | 特定の利用者に依存しないチーム単位の権限 |
個人APIキー発行画面 設定 > 個人設定 > API利用
個人 API キーの発行は、初期状態ではプロファイル「管理者」のみ可能です。
ほかのプロファイルでもご利用の場合は、設定 ＞ 権限 ＞ プロファイルの「個人設定 > API 利用」を ON にしてください。
チームAPIキー発行画面 設定 > API利用 > （新）API利用
チーム API キーは発行時に 1 回のみ表示されます（再表示不可）。
必ずコピーして安全な場所に保管してください。「（新）」が付いていない「API 利用」タブは、現行（v1）の API キー管理画面です。
2. 連携システム側の接続先と認証情報を変更する
項目 | v1 | v2 |
接続先 URL |
|
|
認証情報の渡し方 |
|
|
v1 の API キーは v2 では利用できません。新たに発行した個人 API キー／チーム API キーをご設定ください。
3. 動作が変わる部分を見直す（該当する連携のみ）
一覧・検索のページング：取引先・案件・コンタクト・アクションは、ページ番号の指定ではなく、
前のレスポンスで返る
nextCursorを次のリクエストに渡して続きを取得する方式に変わります（ページの並列取得は不可）。
詳細項目（カスタム項目）のレスポンス：項目の型に対応するプロパティのみ返り、
汎用キーvalueは返りません。no_customs/compact_customsは指定できません。
登録・更新時のバリデーション：画面と同一の基準になります（文字数・桁数制限、選択肢やユーザーの存在確認など）。
API 操作時の通知：画面操作と同様に、アクションや案件の登録・更新にともなう通知が送信されます。
ロックされた案件：個人 API キーでは画面と同じくロックが適用され、更新権限のないユーザーは更新・削除できません（チーム API キーは従来どおり操作できます）。
詳細は API リファレンスをご確認ください。
これらの改良点は AI 連携に限らず有効です。
AI を介さない従来型のシステム連携をご利用の場合でも、v1 より v2 のご利用を推奨します。