---
title: "Create transfer methods"
method: POST
path: "/api/appMarket/v2/transferMethods"
tags: ["Payments v2"]
---

# Create transfer methods

`POST /api/appMarket/v2/transferMethods`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/api/appMarket/v2/transferMethods`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/api/appMarket/v2/transferMethods/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new Transfer Method for the requesting (authenticated) user

## Request body

- TransferMethodRequest: The transfer method creation payload
  - `properties` object, required: The transfer method properties
  - `platformType` string, required: The transfer platform type
  - `partyId` string, required: The ID of the transfer method's party
  - `partyType` string, required: The type of the transfer method's party (USER, CHANNEL, and so on)

## Response `201`

The transfer method request has been created successfully

- TransferMethodResponse: A transfer method response
  - `properties` object, required: The transfer method properties
  - `platformType` string, required: The transfer platform type
  - `partyId` string, required: The ID of the transfer method's party
  - `partyType` string, required: The type of the transfer method's party (USER, CHANNEL, and so on)
  - `id` string, required: The transfer method ID
  - `balance` Balance: The balance of a transfer method
    - `amount` string, amount: A monetary amount
    - `currency` string: The currency of the amount, using the ISO-4217 currency code
  - `displayName` string, required: The transfer method display name

## Other responses

- `400`: Indicates a bad request, which can be due to violation(s) of HTTP or API rules
- `401`: Unauthorized
- `409`: Cannot create duplicate transfer method. A transfer method already exists for this party and platformType
- `500`: Indicates an unknown internal error that prevents the server from processing the request

## Changes

- **2026-11-06** `1fc240f06971`: 1 breaking, 3 info
  - added `#/components/schemas/AbstractTransferMethod, subschema #2: TransferMethodRequest` to the request body `allOf` list
  - added `#/components/schemas/AbstractTransferMethod, subschema #2: TransferMethodResponse` to the response body `allOf` list for the response status `201`
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `500`

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/api/appMarket/v2/transferMethods/post.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)