1. Guides
2. Moov accounts

After you’ve created a Moov account, you can update certain information on the account profile. Some information, like account type, can’t be updated once an account has been fully created and approved.

Update account profiles and transaction data

The verification and underwriting statuses of an account determine what can and can’t be updated. An account’s capability status determines whether most of the account profile can be updated. An account’s underwriting status determines whether the transaction data can be updated.

The table below shows the editing capabilities of capability statuses:

The table below shows the editing capabilities of underwriting statuses:

If you need to update information in a locked state, please contact support and select submit a support ticket for technical issues so we can update and verify the new information.

Update accounts via API

To update an account via the Moov API, use the accounts PATCH endpoint. You can also update an account with Node SDK and Moov.js.

Some business accounts require the additional step of setting ownersProvided to true before Moov can verify an account. The examples below update a business account with this information.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

curl -X PATCH "https://api.moov.io/accounts/{accountID}" \
  -H "Authorization: Bearer {token}" \
  --data-raw '{
    "profile": {
      "business": {
        "ownersProvided": true
      }
    },
    "foreignId": "your-correlation-id"
  }'\

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

mc, _ := moov.NewClient()

account := moov.Account{
  AccountID:   "accountID",
  AccountType: moov.AccountType_Business,
  Profile: moov.Profile{
    Business: &moov.Business{
      OwnersProvided: true,
    },
  },
}

mc.UpdateAccount(ctx, account)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

const moov = new Moov(credentialsObject);

const accountID = "accountID"
const updatedAccount = {
  profile: {
    business: {
      ownersProvided: true,
    }
  } 
};

const account = await moov.accounts.patch(accountID, updatedAccount);

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

const moov = Moov(token);

const accountID = "accountID"
const updatedAccount = {
  profile: {
    business: {
      ownersProvided: true,
    }
  } 
};

moov.accounts.update(accountID, updatedAccount);

Update accounts via Dashboard

See the Dashboard docs for information and instructions.

If a certain field is locked and you can’t update it, this is due to the verification or underwriting status of the account.

Disconnect accounts

Disconnecting an account removes the ability to interact with it. You’ll continue to have read-only access to the account for reporting purposes. The following actions will no longer be available:

• Edit profile
• Edit past transfers
• Upload documents
• Create new transfer
• Create new payment method

Disconnecting an account does not delete the account, its Moov wallet, or account history.

You can disconnect an account through the Dashboard or by providing the accountID in the path when making a request to the accounts DEL endpoint.

If you want to include disconnected accounts when using the list accounts GET endpoint, make sure you set includeDisconnected to true.