Skip to main content
PATCH
/
partner
/
wallets
/
recipients
/
{recipient_id}
Update saved recipient
curl --request PATCH \
  --url https://api.stabyl.com/v1/partner/wallets/recipients/{recipient_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "account_name": "<string>",
  "account_number": "<string>",
  "bank_code": "<string>",
  "bank_name": "<string>",
  "chain": "<string>",
  "crypto_address": "<string>",
  "currency": "<string>",
  "label": "<string>"
}
'
{
  "data": {
    "account_name": "Example Recipient",
    "account_number": "0123456789",
    "bank_code": "044",
    "bank_name": "Access Bank",
    "chain": null,
    "created_at": "2026-05-24T12:00:00Z",
    "crypto_address": null,
    "currency": "NGN",
    "id": "0197f1f0-0000-7000-8000-000000000002",
    "label": "Operations account",
    "recipient_type": "fiat",
    "updated_at": "2026-05-24T12:00:00Z"
  },
  "status": "success"
}

Documentation Index

Fetch the complete documentation index at: https://stabyl.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Saved recipients are address book records. Creating, updating, or deleting a recipient does not submit a withdrawal or move funds.

Authorizations

​
X-Api-Key
string
header
default:sb_test_your_key
required

API key. Send it in the X-Api-Key header.

Path Parameters

​
recipient_id
string<uuid>
required

Saved recipient ID returned by create or list recipient endpoints.

Body

application/json

Mutable recipient fields to update. Bank detail changes require account verification again.

Mutable saved-recipient fields to update.

​
account_name
string | null
​
account_number
string | null
​
bank_code
string | null
​
bank_name
string | null
​
chain
string | null
​
crypto_address
string | null
​
currency
string | null
​
label
string | null

Response

Recipient updated

​
data
object
required

Saved fiat or crypto recipient record.

​
status
enum<string>
required
Available options:
success