---
title: "Update Connect sub-merchant profile"
method: PATCH
path: "/api/connect/accounts/{subMerchantId}"
tags: ["Connect"]
---

# Update Connect sub-merchant profile

`PATCH /api/connect/accounts/{subMerchantId}`

Partial-update of marketplace-controlled profile fields (display name, first/last name, arbitrary metadata). `marketplaceMetadata` is shallow-merged; reserved keys (`connectKyc`, `_inflow_*`) are silently dropped. Email, custodial wallet, KYC state, fees, and suspension are NOT mutable here — see the suspend/resume routes for the suspension toggle.

## Path parameters

- `subMerchantId` string, required

## Request body

- UpdateConnectAccountDto
  - `merchantName` string — Display name / merchant name for the sub-merchant.
  - `firstName` string — First name (individual sub-merchants only).
  - `lastName` string — Last name (individual sub-merchants only).
  - `marketplaceMetadata` object — Arbitrary marketplace metadata. Shallow-merged into the existing object. Reserved keys (`connectKyc`, `_inflow_*`) are silently dropped.

## Response `200`

Update Connect sub-merchant profile successful

- ConnectAccountDto
  - `id` string, required
  - `email` string, required
  - `merchantName` string, nullable, required
  - `firstName` string, nullable, required
  - `lastName` string, nullable, required
  - `accountType` 'INDIVIDUAL' | 'MARKETPLACE' | 'SUB_MERCHANT', required
  - `marketplaceUserId` string, required
  - `marketplaceMetadata` object, nullable, required
  - `customerId` string, nullable, required — KYC provider customer id linked to this sub-merchant
  - `custodialWalletAddress` string, nullable, required — Custodial wallet address for this sub-merchant
  - `stopProcessingSettlement` boolean, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400` — Invalid update payload
- `401` — Unauthorized - Invalid API key
- `404` — Sub-merchant not found or does not belong to this marketplace

---

[API](https://skmtc.net/inflowpay/apis/inflow-api.md) · [All operations](https://skmtc.net/inflowpay/apis/inflow-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/inflowpay/inflow-api/versions/3012dd3dd14a/schema)