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/external addresses", "method" "post", "url" "https //sandbox crbcos com/crypto/v1/external addresses", "description" "", "tab" "examples", "examples" { "languages" \[ { "id" "gvbyb xxxg8aaahk3ybhl", "language" "curl", "code" "curl location 'https //sandbox crbcos com/crypto/v1/external addresses' \\\\\n header 'content type application/json' \\\\\n header 'accept text/plain' \\\\\n header 'authorization bearer \<token>' \\\\\n data '{\n \\"accountnumber\\" \\"2179128455\\",\n \\"title\\" \\"jerry penn onchain\\",\n \\"blockchain\\" \\"etherium\\",\n \\"address\\" \\"f1090ace 0xa4b2ca8f216f33ff21e77b659f70451768c02df6 4ff3 a262 b46400bb611b\\",\n \\"tag\\" \\"test eth\\",\n \\"beneficiary\\" {\n \\"name\\" \\"jerry penn\\",\n \\"addressline1\\" \\"34 howe drive\\",\n \\"city\\" \\"leawood\\",\n \\"stateprovince\\" \\"ks\\",\n \\"countrycode\\" \\"us\\",\n \\"postalcode\\" \\"66206\\"\n }\n}'", "customlabel" "" }, { "id" "geh6twy3yakwtul cogbf", "language" "nodejs", "code" "var https = require('follow redirects') https;\nvar fs = require('fs');\n\nvar options = {\n 'method' 'post',\n 'hostname' 'sandbox crbcos com',\n 'path' '/crypto/v1/external addresses',\n 'headers' {\n 'content type' 'application/json',\n 'accept' 'text/plain',\n 'authorization' 'bearer \<token>'\n },\n 'maxredirects' 20\n};\n\nvar req = https request(options, function (res) {\n var chunks = \[];\n\n res on(\\"data\\", function (chunk) {\n chunks push(chunk);\n });\n\n res on(\\"end\\", function (chunk) {\n var body = buffer concat(chunks);\n console log(body tostring());\n });\n\n res on(\\"error\\", function (error) {\n console error(error);\n });\n});\n\nvar postdata = json stringify({\n \\"accountnumber\\" \\"2179128455\\",\n \\"title\\" \\"jerry penn onchain\\",\n \\"blockchain\\" \\"etherium\\",\n \\"address\\" \\"f1090ace 0xa4b2ca8f216f33ff21e77b659f70451768c02df6 4ff3 a262 b46400bb611b\\",\n \\"tag\\" \\"test eth\\",\n \\"beneficiary\\" {\n \\"name\\" \\"jerry penn\\",\n \\"addressline1\\" \\"34 howe drive\\",\n \\"city\\" \\"leawood\\",\n \\"stateprovince\\" \\"ks\\",\n \\"countrycode\\" \\"us\\",\n \\"postalcode\\" \\"66206\\"\n }\n});\n\nreq write(postdata);\n\nreq end();" }, { "id" "6kponomow1vquytwujijw", "language" "python", "code" "import http client\nimport json\n\nconn = http client httpsconnection(\\"sandbox crbcos com\\")\npayload = json dumps({\n \\"accountnumber\\" \\"2179128455\\",\n \\"title\\" \\"jerry penn onchain\\",\n \\"blockchain\\" \\"etherium\\",\n \\"address\\" \\"f1090ace 0xa4b2ca8f216f33ff21e77b659f70451768c02df6 4ff3 a262 b46400bb611b\\",\n \\"tag\\" \\"test eth\\",\n \\"beneficiary\\" {\n \\"name\\" \\"jerry penn\\",\n \\"addressline1\\" \\"34 howe drive\\",\n \\"city\\" \\"leawood\\",\n \\"stateprovince\\" \\"ks\\",\n \\"countrycode\\" \\"us\\",\n \\"postalcode\\" \\"66206\\"\n }\n})\nheaders = {\n 'content type' 'application/json',\n 'accept' 'text/plain',\n 'authorization' 'bearer \<token>'\n}\nconn request(\\"post\\", \\"/crypto/v1/external addresses\\", payload, headers)\nres = conn getresponse()\ndata = res read()\nprint(data decode(\\"utf 8\\"))" }, { "id" "a6xpx5lmx44czhn txjr", "language" "ruby", "code" "require \\"uri\\"\nrequire \\"json\\"\nrequire \\"net/http\"\n\nurl = uri(\\"https //sandbox crbcos com/crypto/v1/external addresses\\")\n\nhttps = net http new(url host, url port)\nhttps use ssl = true\n\nrequest = net http post new(url)\nrequest\[\\"content type\\"] = \\"application/json\\"\nrequest\[\\"accept\\"] = \\"text/plain\\"\nrequest\[\\"authorization\\"] = \\"bearer \<token>\\"\nrequest body = json dump({\n \\"accountnumber\\" \\"2179128455\\",\n \\"title\\" \\"jerry penn onchain\\",\n \\"blockchain\\" \\"etherium\\",\n \\"address\\" \\"f1090ace 0xa4b2ca8f216f33ff21e77b659f70451768c02df6 4ff3 a262 b46400bb611b\\",\n \\"tag\\" \\"test eth\\",\n \\"beneficiary\\" {\n \\"name\\" \\"jerry penn\\",\n \\"addressline1\\" \\"34 howe drive\\",\n \\"city\\" \\"leawood\\",\n \\"stateprovince\\" \\"ks\\",\n \\"countrycode\\" \\"us\\",\n \\"postalcode\\" \\"66206\\"\n }\n})\n\nresponse = https request(request)\nputs response read body\n" }, { "id" "fmpnodsqnsjsyzuajjnba", "language" "go", "code" "package main\n\nimport (\n \\"fmt\\"\n \\"strings\\"\n \\"net/http\"\n \\"io\\"\n)\n\nfunc main() {\n\n url = \\"https //sandbox crbcos com/crypto/v1/external addresses\\"\n method = \\"post\\"\n\n payload = strings newreader(`{`+\\"\n\\"+`\n \\"accountnumber\\" \\"2179128455\\",`+\\"\n\\"+`\n \\"title\\" \\"jerry penn onchain\\",`+\\"\n\\"+`\n \\"blockchain\\" \\"etherium\\",`+\\"\n\\"+`\n \\"address\\" \\"f1090ace 0xa4b2ca8f216f33ff21e77b659f70451768c02df6 4ff3 a262 b46400bb611b\\",`+\\"\n\\"+`\n \\"tag\\" \\"test eth\\",`+\\"\n\\"+`\n \\"beneficiary\\" {`+\\"\n\\"+`\n \\"name\\" \\"jerry penn\\",`+\\"\n\\"+`\n \\"addressline1\\" \\"34 howe drive\\",`+\\"\n\\"+`\n \\"city\\" \\"leawood\\",`+\\"\n\\"+`\n \\"stateprovince\\" \\"ks\\",`+\\"\n\\"+`\n \\"countrycode\\" \\"us\\",`+\\"\n\\"+`\n \\"postalcode\\" \\"66206\\"`+\\"\n\\"+`\n }`+\\"\n\\"+`\n}`)\n\n client = \&http client {\n }\n req, err = http newrequest(method, url, payload)\n\n if err != nil {\n fmt println(err)\n return\n }\n req header add(\\"content type\\", \\"application/json\\")\n req header add(\\"accept\\", \\"text/plain\\")\n req header add(\\"authorization\\", \\"bearer \<token>\\")\n\n res, err = client do(req)\n if err != nil {\n fmt println(err)\n return\n }\n defer res body close()\n\n body, err = io readall(res body)\n if err != nil {\n fmt println(err)\n return\n }\n fmt println(string(body))\n}" } ], "selectedlanguageid" "gvbyb xxxg8aaahk3ybhl" }, "results" { "languages" \[ { "id" "vvw eg1cazm9nswdn62ez", "language" "200", "code" "{\n \\"id\\" \\"b4cc8ee7 ebff 4b65 875e b4650074d081\\",\n \\"accountnumber\\" \\"2179128455\\",\n \\"partnerid\\" \\"cd9c12f4 7691 424a b38b af5b0134c611\\",\n \\"title\\" \\"jerry penn onchain\\",\n \\"blockchain\\" \\"etherium\\",\n \\"address\\" \\"f1090ace 0xa4b2ca8f216f33ff21e77b659f70451768c02df6 4ff3 a262 b46400bb611b\\",\n \\"tag\\" \\"test eth\\",\n \\"beneficiary\\" {\n \\"name\\" \\"jerry penn\\",\n \\"addressline1\\" \\"34 howe drive\\",\n \\"city\\" \\"leawood\\",\n \\"stateprovince\\" \\"ks\\",\n \\"countrycode\\" \\"us\\",\n \\"postalcode\\" \\"66206\\"\n },\n \\"lastmodifiedat\\" \\"2026 06 10t07 05 18 5089232z\\",\n \\"haspendingchanges\\" false\n}", "customlabel" "" } ], "selectedlanguageid" "vvw eg1cazm9nswdn62ez" }, "request" { "pathparameters" \[], "queryparameters" \[], "headerparameters" \[], "bodydataparameters" \[ { "name" "accountnumber", "kind" "required", "type" "string", "description" "unique identifier of the account from where the payment is sent to the external beneficiary", "" "unique identifier of the account from where the payment is sent to the external beneficiary" }, { "name" "title", "kind" "required", "type" "string", "description" "human readable label for the external wallet (for example, “john’s metamask wallet”) max 255 characters this is like the name you put in your contact list in your phone ", "" "human readable label for the external wallet (for example, “john’s metamask wallet”) max 255 characters this is like the name you put in your contact list in your phone " }, { "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" \[] }, { "name" "haspendingchanges", "kind" "optional", "type" "boolean", "description" "true if changes were made after creating the beneficiary otherwise false when you create a new external beneficiary, always false ", "children" \[] } ], "autogeneratedanchorslug" "endpoint cryptov1external addresses", "legacyhash" "hwri18pfmpeimzy9vh22f" }