Skip to main content

Passthrough Create

Loading...
API endpoint path: /mx/{institutionId}/{mxRealTimeResourcePath}

Transparent passthrough for POST requests to the MX Real Time APIs. The service provides synchronous CRUD operations for users, members, accounts, transactions, and holdings; endpoint paths, headers, query parameters, and request/response schemas are defined in the MX documentation.

Use this endpoint to:

  • Invoke MX Real Time POST APIs to create users, members, accounts, transactions, or holdings (all partners create users; additional resources support the real-time push of institution core data to MX).
  • Push current account, transaction, and holding data from institution core systems to MX to power MX digital experiences with up-to-date financial information.
  • Create dependent resources in the required orchestration order (for example, create a user before members or accounts, and an account before transactions or holdings under that account).
  • Submit JSON or XML request bodies using a URL extension (for example, .json or .xml) and a matching Content-Type header (application/vnd.moneydesktop.mdx.v5+json or application/vnd.moneydesktop.mdx.v5+xml), as documented by MX.
  • Access MX Real Time create operations through the Candescent API Gateway instead of calling MX directly.

Behavior and capabilities:

  • The gateway validates the OAuth V2 bearer token, correlationId, and ext_host, injects MD-API-KEY for MX Real Time routing, and removes Candescent-specific headers before forwarding the request to MX.
  • Proxies requests using the path /mx/{institutionId}/{mxRealTimeResourcePath}, where institutionId corresponds to the MX client_id (used in MX paths such as /{client_id}/...), must match the value in the OAuth V2 token, and is used when forwarding requests to MX.
  • Forwards all MX-supported headers, paths, query parameters, and request payloads without modification.
  • Returns MX HTTP status codes and response payloads without modification.

Request​

Responses​

Response payload returned by the target MX Real Time endpoint. Refer to the MX Real Time APIs documentation for supported schemas and examples.