---
title: "Create transfer platform configurations"
method: POST
path: "/api/appMarket/v2/transferPlatformConfigurations"
tags: ["Payments v2"]
---

# Create transfer platform configurations

`POST /api/appMarket/v2/transferPlatformConfigurations`

## Request

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

Create a transfer platform configuration in the marketplace of the current user

## Request body

- TransferPlatformConfigurationRequest: A transfer platform configuration request
  - `platformType` string, required: The transfer platform type
  - `parameters` object, required: The transfer platform parameters.

## Response `201`

The transfer platform configuration request has been treated successfully

- TransferPlatformConfigurationResponse: A transfer platform configuration response
  - `platformType` string, required: The transfer platform type
  - `parameters` object, required: The transfer platform parameters.
  - `id` string, required: Id of the transfer platform configuration

## 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 configuration. A transfer platform configuration already exists for this tenant and type.
- `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/AbstractTransferPlatformConfiguration, subschema #2: TransferPlatformConfigurationRequest` to the request body `allOf` list
  - added the media type `application/json` for the response with the 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/transferPlatformConfigurations/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)