Customer management
APIs
Update beneficial owner
relevant webhooks for this endpoint be sure you have docid\ bn5xtgkjogbe ctwomcbs for this webhook docid\ rl8xmroegistybme y98d api reference update the beneficial owner details, including the owner title and the percentage owned { "name" "endpoint /core/v1/cm/customers/{customerid}/beneficial owners/{id}", "method" "put", "url" "https //sandbox crbcos com/core/v1/cm/customers/{customerid}/beneficial owners/{id}", "description" "", "tab" "examples", "examples" { "languages" \[ { "id" "b2qwb9wn1dtrmagdjzkxc", "language" "curl", "code" "curl location request put 'https //sandbox crbcos com/core/v1/cm/customers/b73cf966 7886 40a0 88c5 af5b0138fc8c/beneficial owners/7c6c3667 ad62 4a7f 992e b3ae00bbf93c' \\\\\n data '{\n \\"ownertitle\\" \\"ceo\\",\n \\"ownershippercentage\\" 90\n}'", "customlabel" "" }, { "id" "zpbcocvucgz5kitvrnnzr", "language" "nodejs", "code" "var https = require('follow redirects') https;\nvar fs = require('fs');\n\nvar options = {\n 'method' 'put',\n 'hostname' 'sandbox crbcos com',\n 'path' '/core/v1/cm/customers/b73cf966 7886 40a0 88c5 af5b0138fc8c/beneficial owners/7c6c3667 ad62 4a7f 992e b3ae00bbf93c',\n 'headers' {\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 = \\"{\\\r\\\n \\\\\\"ownertitle\\\\\\" \\\\\\"ceo\\\\\\",\\\r\\\n \\\\\\"ownershippercentage\\\\\\" 90\\\r\\\n}\\";\n\nreq write(postdata);\n\nreq end();", "customlabel" "" }, { "id" "va41mtjbvqpgptiiles c", "language" "python", "code" "import http client\n\nconn = http client httpsconnection(\\"sandbox crbcos com\\")\npayload = \\"{\\\r\\\n \\\\\\"ownertitle\\\\\\" \\\\\\"ceo\\\\\\",\\\r\\\n \\\\\\"ownershippercentage\\\\\\" 90\\\r\\\n}\\"\nheaders = {}\nconn request(\\"put\\", \\"/core/v1/cm/customers/b73cf966 7886 40a0 88c5 af5b0138fc8c/beneficial owners/7c6c3667 ad62 4a7f 992e b3ae00bbf93c\\", payload, headers)\nres = conn getresponse()\ndata = res read()\nprint(data decode(\\"utf 8\\"))", "customlabel" "" }, { "id" "gmvw0uwnlhlk2cwjdclm8", "language" "ruby", "code" "require \\"uri\\"\nrequire \\"net/http\"\n\nurl = uri(\\"https //sandbox crbcos com/core/v1/cm/customers/b73cf966 7886 40a0 88c5 af5b0138fc8c/beneficial owners/7c6c3667 ad62 4a7f 992e b3ae00bbf93c\\")\n\nhttps = net http new(url host, url port)\nhttps use ssl = true\n\nrequest = net http put new(url)\nrequest body = \\"{\\\r\\\n \\\\\\"ownertitle\\\\\\" \\\\\\"ceo\\\\\\",\\\r\\\n \\\\\\"ownershippercentage\\\\\\" 90\\\r\\\n}\\"\n\nresponse = https request(request)\nputs response read body\n", "customlabel" "" }, { "id" "hav1d17eyu xo6d7k3v0h", "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/core/v1/cm/customers/b73cf966 7886 40a0 88c5 af5b0138fc8c/beneficial owners/7c6c3667 ad62 4a7f 992e b3ae00bbf93c\\"\n method = \\"put\\"\n\n payload = strings newreader(`{`+\\"\n\\"+`\n \\"ownertitle\\" \\"ceo\\",`+\\"\n\\"+`\n \\"ownershippercentage\\" 90`+\\"\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 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}", "customlabel" "" } ], "selectedlanguageid" "hav1d17eyu xo6d7k3v0h" }, "results" { "languages" \[ { "id" "atm1q1y7kg6k2 cq0iwb6", "language" "200", "code" "{\n \\"id\\" \\"7c6c3667 ad62 4a7f 992e b3ae00bbf93c\\",\n \\"customerid\\" \\"b73cf966 7886 40a0 88c5 af5b0138fc8c\\",\n \\"ownercustomerid\\" \\"53c34cf0 4cd2 4768 937b b30000dffdca\\",\n \\"status\\" \\"active\\",\n \\"ownertitle\\" \\"ceo\\",\n \\"partnerid\\" \\"cd9c12f4 7691 424a b38b af5b0134c611\\",\n \\"createdat\\" \\"2025 12 09t06 24 23 45 05 00\\",\n \\"lastmodifiedat\\" \\"2025 12 09t06 34 37 3375696 05 00\\",\n \\"ownershippercentage\\" 90\n}", "customlabel" "" }, { "id" "hhcnoqpxig0pateobvm 6", "language" "400", "code" "{\n \\"errors\\" \[\n {\n \\"code\\" 2214,\n \\"message\\" \\"entity customer must be a business\\"\n }\n ]\n}", "customlabel" "" } ], "selectedlanguageid" "atm1q1y7kg6k2 cq0iwb6" }, "request" { "pathparameters" \[ { "name" "customerid", "kind" "required", "type" "string", "description" "the customer id of the customer record to update", "" "the customer id of the customer record to update" }, { "name" "id", "kind" "required", "type" "string", "description" "the id returned in the response when the beneficial owner was added this is in guid format ", "" "the id returned in the response when the beneficial owner was added this is in guid format " } ], "queryparameters" \[], "headerparameters" \[], "bodydataparameters" \[ { "name" "ownertitle", "kind" "required", "type" "string", "description" "title or role of the beneficial owner", "" "required" }, { "name" "ownershippercentage", "kind" "optional", "type" "number", "description" "percentage of the business this beneficial owner controls enter the percentage in real numbers for example, if you enter 0 20 it means 0 20% if you enter 20, it means 20% ", "" "percentage of the business this beneficial owner controls enter the percentage in real numbers for example, if you enter 0 20 it means 0 20% if you enter 20, it means 20% " } ], "formdataparameters" \[] }, "currentnewparameter" { "label" "path parameter", "value" "pathparameters" }, "hastryitout" false, "response" \[ { "name" "id", "kind" "optional", "type" "string", "description" "cos id for the beneficial owner record, in guid format (also returned when the beneficial owner is added)" }, { "name" "customerid", "kind" "optional", "type" "string", "description" "the customerid of the customer record being updated", "children" \[] }, { "name" "ownercustomerid", "kind" "optional", "type" "string", "description" "beneficial owner cross river customer id (provided when the beneficial owner was onboarded to cos)", "children" \[] }, { "name" "status", "kind" "optional", "type" "boolean", "description" "status of the customer record can be 'inactive' or 'active'", "children" \[] }, { "name" "ownertitle", "kind" "optional", "type" "string", "description" "title or role of the beneficial owner", "children" \[] }, { "name" "partnerid", "kind" "optional", "type" "string", "description" "your partner id in the cross river system", "children" \[] }, { "name" "createdat", "kind" "optional", "type" "string", "description" "date and time the record was created in this case, the date and time are in this format yyyy mm ddthh\ mm\ ss\[ mmm] ", "children" \[] }, { "name" "lastmodifiedat", "kind" "optional", "type" "string", "description" "internal cross river value date and time the database entry was last modified ", "children" \[] }, { "name" "ownershippercentage", "kind" "optional", "type" "number", "description" "percentage of the business this beneficial owner controls enter the percentage in real numbers for example, if you enter 0 20 it means 0 20% if you enter 20, it means 20% ", "children" \[] } ], "autogeneratedanchorslug" "endpoint corev1cmcustomerscustomeridbeneficial own", "legacyhash" "jsa4n mbepymrcwigu1lk" }