Partial update an external account by id

Update individual fields on an external account object.

Overview

This endpoint allows you to make partial updates to an external account's information - you only have to pass the field(s) you wish to update. This means that end-users will not have to re-enter all fields if they want to update their information.

Required fields:

  • account_reference_id. This field also cannot be changed.

Updating metadata

  • If you do not pass the metadata field, the metadata will not be updated in any way
  • To update an existing metadata key’s value, pass the existing key with the new value along with any existing key-value pair(s)
  • To remove metadata, pass any key-values pair you want to maintain, and omit the ones you want to delete. To remove all metadata, pass the metadata key with an empty object
  • To add new key-value pair(s), pass any existing metadata key-value pair(s) with the new key(s) and new value(s)

Impact on account verification status

If you are using your own third-party provider for account verification, changing the information on the external account will not re-trigger the account verification process. The external account's status will remain "verified".

If you are using Orum for account verification, changing any information on the external account will re-trigger account verification. You will receive an external_account_unverified webhook and the external account's status will be set to "created" until re-verification is complete.

Language
Authorization
Bearer
Click Try It! to start a request and see the response here!