---
title: "Create an exchange for an account"
method: POST
path: "/exchanges"
tags: ["exchanges"]
---

# Create an exchange for an account

`POST /exchanges`

Create an exchange for an account. The request body will vary based on the exchange partner.
For Finicity, the request body will include finicity-specific fields.
For MX Secure Exchange, the request body will include a token.
For Flinks Secure Exchange, the request body will include a token.
For Plaid Secure Exchange, the request body will include a token.

## Request body

- union
  - CreateFinicitySecureExchange
    - `_links` object, required
      - `exchange-partner` object
        - `href` string
    - `finicity` object, required
      - `profile` integer
      - `version` string
      - `receiptId` string
      - `receiptVersion` string
      - `customerId` string
      - `partnerId` integer
      - `products` object[]
        - `product` string
        - `accountId` string
        - `accessPeriod` object
          - `type` string
          - `startTime` string, date
          - `endTime` string, date-time
      - `timestamp` string, date-time
  - CreateTokenBasedExchange — Create an exchange using a token. Supports MX, Plaid, and Flinks secure exchange flows, and Checkout.com for Push to Card (debit card).
    - `_links` object, required
      - `exchange-partner` object, required
        - `href` string
    - `token` string, required — Connection or processor token from the exchange partner (e.g., Plaid, MX, Flinks), or payment ID (pay_xxx) from Checkout.com Flow for Push to Card

## Response `201`

Created

## Other responses

- `400` — Bad Request
- `401` — Invalid Scope
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.dev/dwolla/apis/dwolla-api.md) · [All operations](https://skmtc.dev/dwolla/apis/dwolla-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dwolla/dwolla-api/revisions/0e13062ae3be/schema)