DevelopersAPIReferencemerchants
Merge
Creates the merged merchant, repoints every transaction to it, and deletes the old merchants — one transaction (legacy mergeMerchants).
POST
bearerAuthheader
Authorization<token>A Walletguide API key (wg_…) or an OAuth bearer token. Paste the value only. Create a key under Wallet settings → API keys.
walletId*stringRow uuid
Format
uuidapplication/json- body
newMerchant*merchantIds*array<>Items
1 <= items <= 200The merged (newly created) row
application/json- response
id*stringFormat
uuidwalletId*stringFormat
uuidfirestoreId*string|nullname*stringdefaultCategoryId*|Format
uuiddefaultUsingDateRule*|Value in
"transactionDate""transactionMonth""monthAfterTransactionDate""monthBeforeTransactionDate""yearBeforeTransactionDate""oneMonthFromTransactionDate""oneYearFromTransactionDate""sixMonthsFromTransactionDate""custom"nulldomains*array<string>logo*booleanautoCreatedSource*|Value in
"googleMaps""searchApiGoogleWebSearch""bingWebSearch"nullautoReviewTransactions*booleancreatedTime*|Format
date-timecreatedUserId*string|nulllastUpdatedTime*|Format
date-timelastUpdatedUserId*string|nullcurl -X POST 'https://api.walletguide.com/wallets/497f6eca-6276-4993-bfeb-53cbbbba6f08/merchants/merge' \ -H 'Content-Type: application/json' \ -d '{ "newMerchant": { "name": "string" }, "merchantIds": [ "bb4eabaa-3063-4c17-b736-e0a3f92e1687" ]}'Example Response
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "walletId": "0ecad4a2-3549-43fb-807e-9ff033247480", "firestoreId": "string", "name": "string", "defaultCategoryId": "0f63fd5d-d332-4663-9682-fda5c7d5685d", "defaultUsingDateRule": "transactionDate", "domains": [ "string" ], "logo": true, "autoCreatedSource": "googleMaps", "autoReviewTransactions": true, "createdTime": "2019-08-24T14:15:22Z", "createdUserId": "string", "lastUpdatedTime": "2019-08-24T14:15:22Z", "lastUpdatedUserId": "string"}