API ドキュメント

MoEngage REST API を使用すると、ダッシュボードを使わずにユーザーデータ、キャンペーン、セグメント、コンテンツ、連携を管理できます。すべてのエンドポイントは、標準的な HTTP メソッドと JSON 形式のリクエストボディおよびレスポンスボディを使用し、ダッシュボードで作成した API キーで認証します。このリファレンスでは、利用可能な API カテゴリと、それらすべてに共通するデータセンター、ベース URL、認証、レート制限、エラー処理について説明します。

API カテゴリ

Data

ユーザーの作成と更新、イベントのトラッキング、デバイスの管理、データの一括インポートを行います。

Business Events

ビジネスイベントを作成およびトリガーして、自動化されたキャンペーンを実行します。

Content

テンプレート、コンテンツブロック、レコメンデーション、クーポン、カタログを管理します。

Campaigns

Push キャンペーンと Email キャンペーンをプログラムで作成および管理します。

Segments

ファイルベース、フィルターベース、コホート同期のユーザーセグメントを作成および管理します。

Subscriptions

メールの購読と購読カテゴリの設定を管理します。

Analytics

カスタムダッシュボードにアクセスし、そのチャートの基になる分析データを取得します。

Push

Android、iOS、Web にトランザクションプッシュ通知やターゲットプッシュ通知を送信します。

Cards

ユーザーの App Inbox カードを取得および管理します。

Inform

SMS、Email、Push チャネルでトランザクションアラートを送信します。

Live Activities

ブロードキャストを使用して iOS Live Activities を開始、更新、終了します。

Personalize

ユーザー向けのパーソナライズされたエクスペリエンスを取得および管理します。

Message Archival

アーカイブされたメッセージを表示および取得します。

データセンター

MoEngage は複数のデータセンターを運用しています。サインアップ時に特定のデータセンターが割り当てられます。データセンターはダッシュボードの URL から確認できます。

データセンター	ダッシュボード URL	REST API ホスト
DC-01	`https://dashboard-01.moengage.com`	`https://api-01.moengage.com`
DC-02	`https://dashboard-02.moengage.com`	`https://api-02.moengage.com`
DC-03	`https://dashboard-03.moengage.com`	`https://api-03.moengage.com`
DC-04	`https://dashboard-04.moengage.com`	`https://api-04.moengage.com`
DC-05	`https://dashboard-05.moengage.com`	`https://api-05.moengage.com`
DC-06	`https://dashboard-06.moengage.com`	`https://api-06.moengage.com`
DC-101	`https://dashboard-101.moengage.com`	`https://api-101.moengage.com`

データセンターの選択

ユーザーデータを特定の地理的リージョンに保存する必要があるデータプライバシー要件がある場合:

米国リージョン: DC-01 または DC-04 でサインアップします
EU リージョン: DC-02 でサインアップします
インドリージョン: DC-03 でサインアップします
インドネシアリージョン: DC-06 でサインアップします

DC-05（シンガポール）は新規サインアップでは利用できません。既存の DC-05 ワークスペースは引き続き運用され、API リクエストには引き続き https://api-05.moengage.com を使用します。シンガポールでのデータレジデンシー要件については、カスタマーサクセスマネージャーにお問い合わせください。

ワークスペースでデータが取得された後は、別のデータセンターに移行することはできません。必ず登録済みのデータセンターに対応する REST API エンドポイントを使用してください。

ベース URL

すべての API リクエストは次の URL に送信されます。

https://api-{dc}.moengage.com

{dc} をデータセンター番号（例: 01、02、03）に置き換えてください。データセンターはダッシュボードの URL から確認できます。

各 API には追加のパスセグメント（例: /v1、/core-services/v1）がある場合があります。完全なエンドポイントパスについては、各 API のドキュメントを参照してください。

認証

MoEngage API リクエストでは、デフォルトで Basic 認証を使用します。API グループによっては、キーで代わりに OAuth 2.0 または AWS STS Auth を使用できます。

OAuth 2.0: 有効期間の短いアクセストークンを発行し、各リクエストの Authorization ヘッダーで渡します。トークンエンドポイント、リクエスト形式、トークンのライフサイクルについては、OAuth 2.0 の概要を参照してください。
AWS STS Auth: 各リクエストに署名する AWS の assumed-role ARN によって呼び出し元を承認します。署名の手順、リージョンごとの AWS STS ホスト、リクエストヘッダーについては、AWS STS Auth を参照してください。受け付けられる ARN の形式と、キーに role ARN を許可リスト登録する方法については、API Key Dashboard を参照してください。

認証タイプはキーの作成時に設定します。各 API グループがサポートする認証タイプについては、API Key Dashboard を参照してください。 Basic 認証を使用して認証するには、すべてのリクエストの Authorization ヘッダーに、認証情報を Base64 でエンコードした文字列を含めます。Basic 認証では、‘username:password’ という文字列を Base64 でエンコードし、エンコードされた文字列の先頭に ‘Basic ’ を付けます。この文字列は、次のように Authorization ヘッダーに含めます。 {"Authorization: Basic Base64_ENCODED_WORKSPACEID_APIKEY=="}

必須ヘッダー

Authorization: Basic {base64_encoded_credentials}
MOE-APPKEY: {your_workspace_id} 
Content-Type: application/json

認証情報の生成

Authorization ヘッダーの値は、workspace_id:api_key を Base64 でエンコードしたものです。

# Example: Encoding credentials
echo -n "YOUR_WORKSPACE_ID:YOUR_API_KEY" | base64

認証情報の取得

MoEngage ダッシュボードにログインします。
Settings > Account > APIs に移動します。

Workspace ID と該当する API Key をコピーします。

キーの作成、スコープ設定、再生成、アーカイブについては、API Key Dashboard を参照してください。代わりに OAuth 2.0 で認証するには、OAuth 2.0 の概要を参照してください。 Postman などのクライアントを使用して、次のように認証を行うことができます。

機能別の API キー

API によって、ダッシュボードで必要な API キーが異なります。

API	API キーの場所（Settings → Account → APIs）
Data	Data
Push	Push
Inform	Inform
Campaigns および Catalog	Campaign report/Business events/Custom templates/Catalog API/Inform Report
Personalize	Personalize

IP ホワイトリスト

レート制限

MoEngage は、REST API に対してワークスペースごとのレート制限とペイロードの上限を設けています。レート制限を超えたリクエストには HTTP 429 レスポンスが返され、サイズが大きすぎるペイロードには HTTP 413（または 400）が返されます。レート制限されたレスポンスには x-ratelimit-limit、x-ratelimit-remaining、x-ratelimit-reset ヘッダーが含まれるため、残りの容量をリアルタイムで把握できます。レート制限、ペイロードサイズの上限、モニタリング用ヘッダー、上限引き上げのリクエスト方法を含むエンドポイントごとの詳細については、Rate Limits を参照してください。

エラー処理

ほとんどの MoEngage API は、次の標準形式でエラーを返します。

標準エラー形式

{
  "status": "fail",
  "error": {
    "message": "The request parameters are invalid",
    "type": "Bad Request",
    "request_id": "abc123xyz"
  }
}

Flows などの新しい v5 API では、異なるエラーエンベロープ { response_id, error: { code, message, target, details } } を使用します。正確なエラーの形式については、各 API のリファレンスを参照してください。

HTTP ステータスコード

コード	説明
`200`	成功
`201`	作成済み
`202`	受け付け済み（非同期処理）
`400`	Bad Request - 無効なパラメーター
`401`	Unauthorized - 無効な認証情報
`403`	Forbidden - アクセス拒否
`404`	Not Found - リソースが存在しない
`409`	Conflict - リソースの重複
`413`	Payload Too Large（ペイロードが大きすぎる）
`429`	Rate Limit Exceeded（レート制限超過）
`500`	Internal Server Error（内部サーバーエラー）

主要エンドポイントのリファレンス

Data

app_id（または appId/Workspace_ID）は Workspace ID で、Settings > Account > APIs で確認できます。

メソッド	エンドポイント	説明	Workspace ID の渡し方
`POST`	`/customer/{app_id}`	ユーザーの作成または更新	パス（`app_id`）
`POST`	`/customers/export`	ユーザー詳細の取得	クエリ（`app_id`）
`POST`	`/customer/merge`	2 人のユーザーのマージ	クエリ（`app_id`）
`POST`	`/customer/delete`	ユーザーの一括削除	クエリ（`app_id`）
`POST`	`/event/{Workspace_ID}`	ユーザーイベントのトラッキング	パス（`Workspace_ID`）
`POST`	`/transition/{Workspace_ID}`	一括インポート	パス（`Workspace_ID`）
`POST`	`/device/{app_id}`	デバイスの作成または更新	パス（`app_id`）
`POST`	`/devices/manage`	デバイスの管理	クエリ（`app_id`）
`POST`	`/fileimports/trigger/{schedule_id}`	ファイルインポートのトリガー	ヘッダー（`MOE-APPKEY`）
`POST`	`/fileimports/import/status`	インポートステータスの取得	ヘッダー（`MOE-APPKEY`）
`POST`	`/fileimports/import/run/history`	インポート実行履歴の取得	ヘッダー（`MOE-APPKEY`）
`GET`	`/installInfo`	インストール情報の取得	クエリ（`appId`）
`POST`	`/integrations/authentication`	認証の検証	ヘッダー（`MOE-APPKEY`）
`POST`	`/opengdpr_requests/{appId}`	GDPR/CCPA リクエストの作成	パス（`appId`）

クエリパラメーターのキーはリテラルであり、エンドポイントによって異なります（app_id と appId）。表示されているとおりに正確に送信してください。

OAuth

メソッド	エンドポイント	説明
`POST`	`/v1/oauth/token`	アクセストークンの生成
`POST`	`/v1/oauth/refresh`	アクセストークンの更新

Business Events

メソッド	エンドポイント	説明
`POST`	`/business_event`	ビジネスイベントの作成
`POST`	`/business_event/trigger`	ビジネスイベントのトリガー
`POST`	`/business_event/search`	ビジネスイベントの検索
`POST`	`/v5/business-events/triggers`	ビジネスイベントのトリガー (V5)
`GET`	`/v5/business-events`	ビジネスイベントの一覧表示 (V5)
`POST`	`/v5/business-events/search`	ビジネスイベントの検索 (V5)

Content

テンプレート

メソッド	エンドポイント	説明
`POST`	`/custom-templates/inapp`	In-App テンプレートの作成
`PUT`	`/custom-templates/inapp`	In-App テンプレートの更新
`POST`	`/custom-templates/inapp/search`	In-App テンプレートの検索
`POST`	`/custom-templates/osm`	OSM テンプレートの作成
`PUT`	`/custom-templates/osm`	OSM テンプレートの更新
`POST`	`/custom-templates/osm/search`	OSM テンプレートの検索
`POST`	`/custom-templates/sms`	SMS テンプレートの作成
`PUT`	`/custom-templates/sms`	SMS テンプレートの更新
`POST`	`/custom-templates/sms/search`	SMS テンプレートの検索
`POST`	`/email-templates`	Email テンプレートの作成
`GET`	`/email-templates`	すべての Email テンプレートの取得
`GET`	`/email-templates/{id}`	ID による Email テンプレートの取得
`PUT`	`/email-templates/{id}`	Email テンプレートの更新
`PUT`	`/bulk/email-templates`	Email テンプレートの一括作成または更新
`POST`	`/custom-templates/email`	Email テンプレート V2 の作成
`PUT`	`/custom-templates/email`	Email テンプレート V2 の更新
`POST`	`/custom-templates/email/search`	Email テンプレート V2 の検索
`POST`	`/custom-templates/push`	Push テンプレートの作成
`PUT`	`/custom-templates/push`	Push テンプレートの更新
`POST`	`/custom-templates/push/search`	Push テンプレートの検索

コンテンツブロック

メソッド	エンドポイント	説明
`POST`	`/content-blocks`	コンテンツブロックの作成
`PUT`	`/content-blocks`	コンテンツブロックの更新
`POST`	`/content-blocks/get-by-ids`	ID によるコンテンツブロックの取得
`POST`	`/content-blocks/search`	コンテンツブロックの検索

Content API

メソッド	エンドポイント	説明
`GET`	`/v5/content-apis`	Content API の一覧表示
`POST`	`/v5/content-apis/{id}/test`	Content API のテスト

ロケール

メソッド	エンドポイント	説明
`GET`	`/v5/locales`	ロケールの一覧表示

レコメンデーション

メソッド	エンドポイント	説明
`GET`	`/recommendations`	すべてのレコメンデーションの一覧表示
`GET`	`/recommendations/{recommendation_id}`	レコメンデーションの詳細の取得
`POST`	`/recommendations/{recommendation_id}/items`	ユーザー向けのおすすめアイテムの取得

クーポン

メソッド	エンドポイント	説明
`POST`	`/coupon-list`	クーポンリストの作成
`GET`	`/coupon-list`	クーポンリストの一覧表示
`GET`	`/coupon-list/{coupon_list_id}`	クーポンリストの取得
`PATCH`	`/coupon-list/{coupon_list_id}`	クーポンリストの更新
`PUT`	`/coupon-list/{coupon_list_id}/activate`	クーポンリストの有効化
`PUT`	`/coupon-list/{coupon_list_id}/archive`	クーポンリストのアーカイブ
`POST`	`/coupon-list/{coupon_list_id}/files`	クーポンファイルのアップロード
`GET`	`/coupon-list/{coupon_list_id}/files`	クーポンファイルの一覧表示
`GET`	`/coupon-list/{coupon_list_id}/files/{coupon_file_id}`	クーポンファイルの取得
`DELETE`	`/coupon-list/{coupon_list_id}/files/{coupon_file_id}`	クーポンファイルの削除
`POST`	`/coupon-list/{coupon_list_id}/usage-report`	使用状況レポートの取得

カタログ

メソッド	エンドポイント	説明
`POST`	`/catalog`	カタログの作成
`PATCH`	`/catalog/{catalog_id}/attributes`	カタログ属性の追加
`POST`	`/catalog/{catalog_id}/items`	カタログアイテムの取り込み
`POST`	`/catalog/{catalog_id}/items/search`	カタログアイテムの検索
`PATCH`	`/catalog/{catalog_id}/items`	カタログアイテムの更新
`POST`	`/catalog/{catalog_id}/items/bulk-delete`	カタログアイテムの削除

オファリング

メソッド	エンドポイント	説明
`POST`	`/v5/offers`	オファリングの作成
`GET`	`/v5/offers`	オファリングの一覧表示
`GET`	`/v5/offers/{offer_id}`	オファリングの取得
`PATCH`	`/v5/offers/{offer_id}`	オファリングの更新
`GET`	`/v5/offers/templates`	オファーテンプレートの一覧表示
`GET`	`/v5/offers/templates/{template_id}`	オファーテンプレートの取得

Campaigns

メソッド	エンドポイント	説明
`POST`	`/campaigns`	キャンペーンの作成
`PATCH`	`/campaigns/{campaign_id}`	キャンペーンの更新
`POST`	`/campaigns/search`	キャンペーンの検索
`POST`	`/campaigns/test`	キャンペーンのテスト
`POST`	`/personalization/preview`	パーソナライズのプレビュー
`POST`	`/campaigns/meta`	キャンペーンメタデータの取得
`POST`	`/campaigns/status`	キャンペーンステータスの取得
`POST`	`/campaigns/{parent_campaign_id}/executions`	キャンペーン実行履歴の取得
`PUT`	`/global-control-group/users`	Global Control Group ユーザーの更新
`POST`	`/v5/campaigns`	キャンペーンドラフトの作成 (V5)
`GET`	`/v5/campaigns/{campaign_id}`	キャンペーンの取得 (V5)
`PATCH`	`/v5/campaigns/{campaign_id}`	キャンペーンの更新 (V5)
`POST`	`/v5/campaigns/{campaign_id}/validate`	キャンペーンの検証 (V5)
`PATCH`	`/v5/campaigns/{campaign_id}/status`	キャンペーンステータスの更新 (V5)
`POST`	`/v5/campaigns/search`	キャンペーンの検索 (V5)
`POST`	`/v5/campaigns/meta`	キャンペーンメタデータの取得 (V5)
`POST`	`/v5/campaigns/test`	キャンペーンのテスト (V5)
`POST`	`/core-services/v1/campaign-stats`	キャンペーン統計の取得
`GET`	`/campaign_reports/rest_api/{APP_ID}/{FILENAME}`	キャンペーンレポートのダウンロード

Flows

メソッド	エンドポイント	説明
`POST`	`/v5/flows/search`	Flow の検索
`GET`	`/v5/flows/{flow_id}`	Flow の取得
`GET`	`/v5/flows/{flow_id}/versions/{version_id}`	Flow バージョンの取得
`PATCH`	`/v5/flows/{flow_id}/status`	Flow ステータスの更新

Segments

メソッド	エンドポイント	説明
`POST`	`/v2/custom-segments/file-segment`	ファイルセグメントの作成
`PUT`	`/v2/custom-segments/file-segment/add-users`	セグメントへのユーザーの追加
`PUT`	`/v2/custom-segments/file-segment/remove-users`	セグメントからのユーザーの削除
`PUT`	`/v2/custom-segments/file-segment/replace`	セグメントユーザーの置き換え
`GET`	`/v3/custom-segments`	フィルターセグメントの一覧表示
`POST`	`/v3/custom-segments`	フィルターセグメントの作成
`GET`	`/v3/custom-segments/{id}`	ID によるセグメントの取得
`PATCH`	`/v3/custom-segments/{id}`	フィルターセグメントの更新
`POST`	`/v1/integrations/cohortsync`	コホートオーディエンスの同期
`PATCH`	`/v2/custom-segments/archive`	セグメントのアーカイブ
`PATCH`	`/v2/custom-segments/unarchive`	セグメントのアーカイブ解除

Analytics

メソッド	エンドポイント	説明
`GET`	`/v5/analytics/dashboards`	ダッシュボードの一覧表示
`GET`	`/v5/analytics/dashboards/{dashboard_id}/charts`	ダッシュボードのチャートの取得
`GET`	`/v5/analytics/dashboards/{dashboard_id}/charts/{chart_id}`	チャートデータの取得
`POST`	`/v5/analytics/behavior`	Behavior クエリの登録
`POST`	`/v5/analytics/funnels`	Funnels クエリの登録
`POST`	`/v5/analytics/retention`	Retention クエリの登録
`POST`	`/v5/analytics/session-source`	Session Source クエリの登録
`POST`	`/v5/analytics/user-analysis`	User Analysis クエリの登録
`GET`	`/v5/analytics/query/{request_id}/status`	クエリステータスの取得
`GET`	`/v5/analytics/query/{request_id}/results`	クエリ結果の取得

Subscriptions

メソッド	エンドポイント	説明
`POST`	`/emails/v1.0/bulk-resubscribe`	メールの一括再購読
`PUT`	`/v1.0/opt-in-management/user-preferences`	オプトイン設定の更新
`GET`	`/category-subscription/user-preferences`	購読設定の取得
`PUT`	`/category-subscription/user-preferences`	購読設定の更新
`POST`	`/category-subscription/user-preferences`	購読設定の作成
`GET`	`/v5/subscription-categories`	購読カテゴリの取得 (V5)
`GET`	`/v5/subscription-preferences`	購読設定の取得 (V5)
`PATCH`	`/v5/subscription-preferences`	購読設定の更新 (V5)

Push

メソッド	エンドポイント	説明
`POST`	`/v5/push/notifications`	プッシュ通知の送信 (V5)
`POST`	`/v2.1/transaction/sendpush`	プッシュ通知の送信（v2.1、2026 年 11 月 30 日以降は動作しなくなります）
`POST`	`/transaction/sendpush`	プッシュ通知の送信（v2、2026 年 11 月 30 日以降は動作しなくなります）

Cards

メソッド	エンドポイント	説明
`POST`	`/cards/fetch`	カードの取得
`DELETE`	`/cards/delete`	カードの削除

Inform

メソッド	エンドポイント	説明
`POST`	`/alerts/send`	トランザクションアラートの送信（SMS/Email/Push）

Live Activities

メソッド	エンドポイント	説明
`POST`	`/live-activity/broadcast/start`	Live Activity の開始
`POST`	`/live-activity/broadcast/update`	Live Activity の更新
`POST`	`/live-activity/broadcast/end`	Live Activity の終了

Personalize

メソッド	エンドポイント	説明
`POST`	`/experiences/fetch`	エクスペリエンスの取得
`GET`	`/experiences/metadata`	エクスペリエンスメタデータの取得
`POST`	`/experiences/events`	エクスペリエンスイベントのトラッキング

Message Archival

メソッド	エンドポイント	説明
`POST`	`/archival/view`	アーカイブされたメッセージの表示

サポート

API についてサポートが必要ですか？

サポート: カスタマーサクセスマネージャーにお問い合わせいただくか、サポートチケットを作成してください。

​API カテゴリ

Data

Business Events

Content

Campaigns

Segments

Subscriptions

Analytics

Push

Cards

Inform

Live Activities

Personalize

Message Archival

​データセンター

​データセンターの選択

​ベース URL

​認証

​必須ヘッダー

​認証情報の生成

​認証情報の取得

​機能別の API キー

​IP ホワイトリスト

​レート制限

​エラー処理

​標準エラー形式

​HTTP ステータスコード

​主要エンドポイントのリファレンス

​Data

​OAuth

​Business Events

​Content

​テンプレート

​コンテンツブロック

​Content API

​ロケール

​レコメンデーション

​クーポン

​カタログ

​オファリング

​Campaigns

​Flows

​Segments

​Analytics

​Subscriptions

​Push

​Cards

​Inform

​Live Activities

​Personalize

​Message Archival

​サポート

API カテゴリ

データセンター

データセンターの選択

ベース URL

認証

必須ヘッダー

認証情報の生成

認証情報の取得

機能別の API キー

IP ホワイトリスト

レート制限

エラー処理

標準エラー形式

HTTP ステータスコード

主要エンドポイントのリファレンス

Data

OAuth

Business Events

Content

テンプレート

コンテンツブロック

Content API

ロケール

レコメンデーション

クーポン

カタログ

オファリング

Campaigns

Flows

Segments

Analytics

Subscriptions

Push

Cards

Inform

Live Activities

Personalize

Message Archival

サポート