MX

Many banks leverage MX for transaction cleansing and categorization. Hurdlr lets you build directly on top of your MX integration.

1. How it works

Through Hurdlr's MX integration, your user's transactions are pushed into Hurdlr immediately after MX has cleansed them. All of those transactions are then run through Hurdlr's proprietary algorithms, which leverage the user's business type, accountant best practices, and the behavior of similar businesses within the Hurdlr app's 700k+ users.

That data can then be instantly leveraged throughout Hurdlr's APIs, which include expense categorization, tax categorization, financial reporting, tax estimates, tax reporting, tax filing, and many other features.

You can also quickly and easily embed Hurdlr's white-labelled UI into your product, which automatically leverages the data from your MX integration.

2. Pushing transactions into the Hurdlr API

Once you have received your cleansed transactions from MX, you can simply POST those transactions into the Hurdlr API:

curl \
  --request POST \
  --url https://sandbox.hurdlr.com/rest/v5/banks/transactions \
  --header 'Authorization: Bearer ${access_token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "transactions": [
      {
        "apiTransactionId": "1123144594",
        "date": "2020-08-27 00:00:00.000",
        "amount": 500.39,
        "description": "United Airlines",
        "mxCategoryName": "Air Travel",
        "apiAccountId": "459043850",
        "apiAccountNo": "5435",
        "apiAccountName": "Citi Premier® Card",
        "apiAccountType": "CREDIT",
        "apiInstitutionId": "Citi"
      }
    ]
  }'

On each transaction, you can provide the following attributes:

Field	Description	Format
apiTransactionId	Id of the transaction record in your DB	Any string
date	Date that the transaction was incurred	`yyyy-MM-dd'T'HH:mm:ss.SSSZ`
amount	Total value of the transaction; deposits should be positive and withdrawals should be negative	Numeric, with 2 decimal places
description	Transaction `description` from MX	Any string
mxCategoryName	Transaction `category` from MX	Any string
apiAccountId	Id of the transaction's bank account in your DB	Any string
apiAccountNo	Mask of the user's bank account, often the last 4 digits of the account number (used in reporting)	2-4 Alphanumeric characters
apiAccountName	Display name for the user's bank account (used in reporting)	Any string
apiAccountType	Type of the user's bank account	Must be one of the following: "CREDIT", "DEPOSITORY"
apiInstitutionId	Name of the institution that the transaction originated from (used in reporting)	Any string

3. Next Steps

After your user's transactions are pushed into the Hurdlr API, all of Hurdlr's Expense Tracking and Income Streams features will immediately become available to your user, both in the Embeddable User Interface and via API.

Whether you are building your own UX from scratch or have some existing functionality that you are looking to enhance, the Hurdlr API team is here to help. Don't hesitate to email us at [email protected], and we would be glad to help you create and complete the best next steps for your product and vision.