> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teel.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Update recipient

> Update a recipient. Any field you omit stays unchanged.

Omitted fields stay unchanged.

<Info>**Scope** `recipients:write` · rate-limited</Info>

## Headers

<ParamField header="Authorization" type="string" required>
  API key.
</ParamField>

## Path parameters

<ParamField path="id" type="string" required>UUID.</ParamField>

## Request body

<ParamField body="email" type="string" />

<ParamField body="businessName" type="string" />

<ParamField body="firstName" type="string" />

<ParamField body="lastName" type="string" />

<ParamField body="country" type="string">ISO 3166-1 alpha-2.</ParamField>

<ParamField body="phone" type="string" />

<ParamField body="address" type="object">
  <Expandable title="address">
    <ParamField body="streetLine1" type="string" />

    <ParamField body="streetLine2" type="string" />

    <ParamField body="city" type="string" />

    <ParamField body="state" type="string" />

    <ParamField body="postalCode" type="string" />

    <ParamField body="country" type="string" />
  </Expandable>
</ParamField>

<ParamField body="externalReference" type="object">Replaces the stored map. Send `{}` to clear.</ParamField>

<Tabs>
  <Tab title="Fiat (bank)">
    <ParamField body="transferType" type="string">`"fiat"`</ParamField>

    <ParamField body="paymentMethods" type="object[]">
      Full replacement. See [Create recipient](/api-reference/recipients/create) for per-rail fields.
    </ParamField>
  </Tab>

  <Tab title="Stablecoin (wallet)">
    <ParamField body="transferType" type="string">`"stablecoin"`</ParamField>
    <ParamField body="walletAddresses" type="object">Full replacement of the chain → address map.</ParamField>
  </Tab>
</Tabs>

## Response

Same shape as [Get recipient](/api-reference/recipients/get#response).

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "8b1a4c1d-7a3c-4a08-94ad-9f1ef1e0c3a2",
    "email": "payments-new@acme-ph.com",
    "isBusiness": true,
    "businessName": "Acme Corp Philippines",
    "country": "PH",
    "currency": "PHP",
    "transferType": "fiat",
    "externalReference": { "vendor_id": "ACME-001" },
    "status": "accepted",
    "createdAt": "2026-06-09T10:00:00Z",
    "updatedAt": "2026-06-09T11:30:00Z"
  }
  ```
</ResponseExample>