---
title: "Update External Transfer"
method: PUT
path: "/external-transfers/{externalTransferId}"
tags: ["External Transfers"]
---

# Update External Transfer

`PUT /external-transfers/{externalTransferId}`

## Request

- Base URL: `https://partner-api.getpliant.com/api`
- URL: `https://partner-api.getpliant.com/api/external-transfers/{externalTransferId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/getpliant/apis/pliant-customer-api/docs/external-transfers/:externalTransferId/put.ts> (a function with typed inputs; its response is checked against the schema)

Update an existing external transfer. You can modify the transfer details including beneficiary, amount, transfer method, and other properties.

Note that transfers can only be modified when they are in DRAFT status. Once submitted for processing, most fields become read-only.

## Path parameters

- `externalTransferId` string, uuid, required

## Request body

- object
  - `beneficiaryId` string, uuid, required: The beneficiary who will receive the transfer.
  - `beneficiaryPaymentDetailId` string, uuid: The payment details for the beneficiary.
  - `sourceCardAccountId` string, uuid: The card account from which the transfer will be made.
  - `transferAmount` object: The amount of the transfer.
    - `value` number: The value of the monetary amount, converted to minor units of the currency. For instance 1.00 EUR is 100 cents, thus the value here is `100`. See our [guides](/docs/monetary-values) for more details about how to handle monetary amounts.
    - `currency` string: The currency of the monetary amount in ISO 4217 format. Same-currency transfers support the following currencies, with the following `transferMethod` rules: - `EUR`: `SEPA_CREDIT_TRANSFER` - `SEK`, `DKK`: `INSTANT_CREDIT_TRANSFER` - `GBP`: `INSTANT_CREDIT_TRANSFER` (UK Faster Payments) for UK local accounts (account number and sort code), omit `transferMethod` for IBAN accounts - `AED`, `CZK`, `HUF`, `NOK`, `PLN`, `RON`, `USD`: omit `transferMethod`
  - `transferMethod` 'SEPA_CREDIT_TRANSFER' | 'INSTANT_CREDIT_TRANSFER': The transfer method for the external transfer. Whether it is required depends on the transfer currency: - `SEPA_CREDIT_TRANSFER`: SEPA Standard Credit Transfer (SCT). Required for `EUR` transfers. - `INSTANT_CREDIT_TRANSFER`: Instant payment. SEPA Instant for `SEK` and `DKK` transfers, UK Faster Payments for `GBP` transfers to UK local accounts (account number and sort code). Required for these transfers. For all other supported currencies (`AED`, `CZK`, `HUF`, `NOK`, `PLN`, `RON`, `USD`, and `GBP` transfers to IBAN accounts) this field must be omitted — the rail is selected automatically and sending a value is rejected.
  - `purpose` string: The purpose or description of the transfer.
  - `invoiceNumber` string: The invoice number associated with the transfer.
  - `invoiceDate` string, date: The date of the invoice.
  - `dueDate` string, date: The due date for the transfer.
  - `transferTime` string, date-time: The scheduled time for the transfer.

## Response `200`

Ok

- Schema (unresolved $ref)

## Other responses

- `400` (unresolved $ref)
- `401` (unresolved $ref)
- `403` (unresolved $ref)
- `404` (unresolved $ref)
- `409` (unresolved $ref)
- `429` (unresolved $ref)
- `500` (unresolved $ref)

## Changes

- **2026-11-03** `a4fbf7d068b4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getpliant/apis/pliant-customer-api/changes/external-transfers/:externalTransferId/put.md)

---

[API](https://skmtc.dev/getpliant/apis/pliant-customer-api.md) - [All operations](https://skmtc.dev/getpliant/apis/pliant-customer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getpliant/apis/pliant-customer-api/revisions/a4fbf7d068b4?raw)