Create external beneficiary

api reference creates an external beneficiary record (wallet + beneficiary details) for a given account this external beneficiary can then be used by partners as a payment destination on supported blockchains { "name" "endpoint /crypto/v1/accounts/{accountnumber}/external addresses", "method" "post", "url" "https //sandbox crbcos com/crypto/v1/accounts/{accountnumber}/external addresses", "description" "", "tab" "examples", "examples" { "languages" \[ { "id" "gvbyb xxxg8aaahk3ybhl", "language" "curl", "code" "/v1/accounts/2917000057/external addresses\n\n{\n \\"title\\" \\"john's meta mask\\",\n \\"blockchain\\" \\"ethereum\\",\n \\"address\\" \\"0x0e6f76783822826ed173fee6265bdbbdfed4a0f5\\",\n \\"tag\\" \\"john eth\\",\n \\"beneficiary\\" {\n \\"name\\" \\"john doe\\",\n \\"addressline1\\" \\"2115 linwood\\",\n \\"addressline2\\" \\"ave\\",\n \\"city\\" \\"fort lee\\",\n \\"stateprovince\\" \\"nj\\",\n \\"countrycode\\" \\"us\\",\n \\"postalcode\\" \\"07024\\"\n }\n}", "customlabel" "" } ], "selectedlanguageid" "gvbyb xxxg8aaahk3ybhl" }, "results" { "languages" \[ { "id" "vvw eg1cazm9nswdn62ez", "language" "200", "code" "{\n \\"id\\" \\"6d5a90a0 4967 44ba 8380 b39d011abba0\\",\n \\"accountnumber\\" \\"2917000057\\",\n \\"partnerid\\" \\"7712a77c 60a7 49c5 9f08 b1a1012d253f\\",\n \\"title\\" \\"john's meta mask\\",\n \\"blockchain\\" \\"ethereum\\",\n \\"address\\" \\"0x0e6f76783822826ed173fee6265bdbbdfed4a0f5\\",\n \\"tag\\" \\"john eth\\",\n \\"beneficiary\\" {\n \\"name\\" \\"john doe\\",\n \\"addressline1\\" \\"2115 linwood\\",\n \\"addressline2\\" \\"ave\\",\n \\"city\\" \\"fort lee\\",\n \\"stateprovince\\" \\"nj\\",\n \\"countrycode\\" \\"us\\",\n \\"postalcode\\" \\"07024\\"\n },\n \\"lastmodifiedat\\" \\"2025 11 22t17 09 23 9971536z\\"\n}", "customlabel" "" } ], "selectedlanguageid" "vvw eg1cazm9nswdn62ez" }, "request" { "pathparameters" \[ { "name" "accountnumber", "kind" "required", "type" "string", "description" "unique identifier of the account whose wallet addresses will be retrieved", "" "unique identifier of the account whose wallet addresses will be retrieved" } ], "queryparameters" \[], "headerparameters" \[], "bodydataparameters" \[ { "name" "title", "kind" "required", "type" "string", "description" "human readable label for the external wallet (for example, “john’s metamask wallet”) max 255 characters ", "" "human readable label for the external wallet (for example, “john’s metamask wallet”) max 255 characters " }, { "name" "blockchain", "kind" "required", "type" "string", "description" "blockchain network where payments will be sent (for example, solana, ethereum) maximum 20 characters ", "" "blockchain network where payments will be sent (for example, solana, ethereum) maximum 20 characters " }, { "name" "address", "kind" "required", "type" "string", "description" "blockchain wallet address of the beneficiary maximum 255 characters ", "" "blockchain wallet address of the beneficiary maximum 255 characters " }, { "name" "tag", "kind" "optional", "type" "string", "description" "tag/memo/destination tag if the blockchain requires it maximum 255 characters ", "" "tag/memo/destination tag if the blockchain requires it maximum 255 characters " }, { "name" "beneficiary", "kind" "required", "type" "object", "description" "the person or business that receives the payment", "" "the person or business that receives the payment", "children" \[ { "name" "name", "kind" "required", "type" "string", "description" "full legal name of the beneficiary maximum 200 characters" }, { "name" "addressline1", "kind" "required", "type" "string", "description" "first line of the beneficiary’s physical address maximum 80 characters" }, { "name" "addressline2", "kind" "optional", "type" "string", "description" "second line of the beneficiary’s physical address maximum 80 characters " }, { "name" "city", "kind" "required", "type" "string", "description" "full name of the city where the beneficiary is located maximum 40 characters " }, { "name" "stateprovince", "kind" "required", "type" "string", "description" "2 letter code for the state or province of the beneficiary maximum 2 characters" }, { "name" "countrycode", "kind" "required", "type" "string", "description" "2 letter iso country code for the beneficiary's country maximum 2 characters " }, { "name" "postalcode", "kind" "required", "type" "string", "description" "postal or zip code of the beneficiary maximum 20 characters " } ], "schema" \[ { "name" "name", "kind" "required", "type" "string", "description" "full legal name of the beneficiary maximum 200 characters" }, { "name" "addressline1", "kind" "required", "type" "string", "description" "first line of the beneficiary’s physical address maximum 80 characters" }, { "name" "addressline2", "kind" "optional", "type" "string", "description" "second line of the beneficiary’s physical address maximum 80 characters " }, { "name" "city", "kind" "required", "type" "string", "description" "full name of the city where the beneficiary is located maximum 40 characters " }, { "name" "stateprovince", "kind" "required", "type" "string", "description" "2 letter code for the state or province of the beneficiary maximum 2 characters" }, { "name" "countrycode", "kind" "required", "type" "string", "description" "2 letter iso country code for the beneficiary's country maximum 2 characters " }, { "name" "postalcode", "kind" "required", "type" "string", "description" "postal or zip code of the beneficiary maximum 20 characters " } ] } ], "formdataparameters" \[] }, "currentnewparameter" { "label" "body parameter", "value" "bodydataparameters" }, "hastryitout" false, "response" \[ { "name" "id", "kind" "optional", "type" "string", "description" "unique identifier of the external beneficiary record" }, { "name" "accountnumber", "kind" "optional", "type" "string", "description" "account number associated with the beneficiary", "children" \[] }, { "name" "partnerid", "kind" "optional", "type" "string", "description" "your unique id in the cross river system this id is in guid format here it indicates what partner created and owns this beneficiary record ", "children" \[] }, { "name" "title", "kind" "optional", "type" "string", "description" "human readable label for the wallet (for example, eth, sol, ethereum)", "children" \[] }, { "name" "blockchain", "kind" "optional", "type" "string", "description" "blockchain network where payments will be sent (for example, solana, ethereum)", "children" \[] }, { "name" "address", "kind" "optional", "type" "string", "description" "blockchain wallet address of the beneficiary", "children" \[] }, { "name" "tag", "kind" "optional", "type" "string", "description" "tag/memo/destination tag if the blockchain requires it", "children" \[] }, { "name" "beneficiary", "kind" "optional", "type" "object", "description" "the person or business that receives the payment", "children" \[ { "name" "name", "kind" "optional", "type" "string", "description" "full legal name of the beneficiary" }, { "name" "addressline1", "kind" "optional", "type" "string", "description" "first line of the beneficiary’s physical address" }, { "name" "addressline2", "kind" "optional", "type" "string", "description" "second line of the beneficiary’s physical address (nullable)" }, { "name" "city", "kind" "optional", "type" "string", "description" "full name of the city where the beneficiary is located" }, { "name" "stateprovince", "kind" "optional", "type" "string", "description" "2 letter code for the state or province of the beneficiary" }, { "name" "countrycode", "kind" "optional", "type" "string", "description" "2 letter iso country code for the beneficiary's country" }, { "name" "postalcode", "kind" "optional", "type" "string", "description" "postal or zip code of the beneficiary" } ] }, { "name" "lastmodifiedat", "kind" "optional", "type" "string", "description" "internal cross river value date and time the database entry was last modified in this case, the date and time are in this format yyyy mm ddthh\ mm\ ss\[ mmm]", "children" \[] } ], "autogeneratedanchorslug" "endpoint cryptov1accountsaccountnumberexternal add", "legacyhash" "hwri18pfmpeimzy9vh22f" }