View as Markdown
MX Technologies icon

MX Technologies ACTION

Create Account

Creates a new account for a specific user. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's MX Technologies account once, then configure and run Create Account from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "mx_technologies-create-account",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    mx_technologies: { authProvisionId: "apn_xxxxxxx" },
    userId: "User ID",
    accountType: "Account Type",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Account inputs
Property Type Description
userId User ID string
The unique identifier for a user.
Required Dynamic
accountType Account Type string
The general or parent type of the account.
Required
name Name string
The human-readable name for the account.
Required
apr APR string
The annual percentage rate associated with the account.
Optional
apy APY string
The annual percentage yield associated with the account.
Optional
availableBalance Available Balance string
The balance that is available for use in asset accounts like checking and savings. PENDING transactions are typically taken into account with the available balance, but this may not always be the case. available_balance will usually be a positive value for all account types, determined in the same way as the balance field.
Optional
balance Balance string
The current balance of the account. PENDING transactions are typically not taken into account with the current balance, but this may not always be the case. This is the value used for the account balance displayed in MX UIs. The balance will usually be a positive value for all account types. Asset-type accounts (CHECKING, SAVINGS, INVESTMENT) may have a negative balance if they are in overdraft. Debt-type accounts (CREDIT_CARD, LOAN, LINE_OF_CREDIT, MORTGAGE) may have a negative balance if they are overpaid.
Optional
cashSurrenderValue Cash Surrender Value string
The sum of money paid to the policyholder or annuity holder in the event the policy is voluntarily terminated before it matures, or the insured event occurs.
Optional
creditLimit Credit Limit string
The credit limit associated with the account.
Optional
currencyCode Currency Code string
The three-character ISO 4217 currency code.
Optional
deathBenefit Death Benefit integer
The amount paid to the beneficiary of the account upon death of the account owner.
Optional
interestRate Interest Rate string
The interest rate associated with the account.
Optional
isClosed Is Closed boolean
This indicates whether an account has been closed.
Optional
isHidden Is Hidden boolean
This indicates whether the account is hidden.
Optional
loanAmount Loan Amount string
The amount of the loan associated with the account.
Optional
metadata Metadata object
Additional information a partner can store on the account.
Optional
nickname Nickname string
An alternate name for the account.
Optional
originalBalance Original Balance string
The original balance associated with the account.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
mx_technologies-create-account
Version
0.0.2
App
MX Technologies
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes