Add a beneficial owner

a beneficial owner is a person who owns 25% or more of a business for regulatory reasons, you need to create a beneficial owner resource in a business customer record for each beneficial owner of that business each beneficial owner will have a personal customer record that includes a unique customer id the ownercustomerid attribute in the call described here references the personal customer id for each beneficial owner you usually add beneficial owner resources to the business customer record immediately after onboarding a business if you are a cr partner using cr credit bin sponsorship to provide commercial card services (and not to individual cardholders) use this endpoint to associate individual cardholder customer records with their employer business customer record in this tutorial, you'll learn how to ✅ update a cos customer record with a beneficial owner resource if you are new to customer management, we recommend you read our customer management documentation the tutorial assumes you have a knowledge of apis and how they work refer to the api basics page for more details the tutorial uses these api endpoints api description post /core/v1/cm/customers/{businesscustomerid}/beneficial owners adds a beneficial owner resource to customer details before you begin make sure you have bank rails customer id of the business customer record to be updated (only available once the business is onboard a customer ) customer id of the beneficial owner personal customer record (only available once the beneficial owner is onboard a customer ) or the customer id of the business customer record to associate an individual cardholder customer record with their employer customer record beneficial owner title as it appears in their customer record add a beneficial owner resource to an existing customer record when you onboard a business customer, you'll need to add any beneficial owners as resources for the business if you're using credit bin sponsorship to provide credit card services for businesses, you need to add each cardholder as a beneficial owner resource to the business customer record in that case, the ownertitle for each cardholder is auth user in this tutorial, you'll add the ceo of a business as a beneficial owner resource to a business customer record to add identification information call post /core/v1/cm/customers/{customerid}/beneficial owners the attributes below are required detail request attribute name value used in the sample request (not valid) cr customer id for the business customer record being updated (provided when the customer was onboarded to cos) customerid e2a76a89 b5ff 46f1 bf4d 494579d7bb71 beneficial owner cr customer id (provided when the beneficial owner was onboarded to cos) ownercustomerid 83454c7a e5d3 4f3a 8633 11dd49389de2 title or role of the beneficial owner ownertitle ceo important we highly recommend you include an idempotency in your request header to provide duplicate protection in the event of a failure curl x post \ header 'content type application/json' \ header 'accept application/json' \ header 'authorization bearer \<token>' d '{ \\ "ownercustomerid" "83454c7a e5d3 4f3a 8633 11dd49389de2", "ownertitle" "ceo", }' 'https //sandbox crbcos com/core/v1/cm/customers/e2a76a89 b5ff 46f1 bf4d 494579d7bb71/beneficial owners' a successful api call returns a json response confirming the beneficial owner added in cos the id attribute indicates the cos id of the beneficial owner record in the sample below, the id is 6d441e6d cd94 4be1 bd30 3890fcad3100 yours will be different response sample { "id" "6d441e6d cd94 4be1 bd30 3890fcad3100", "customerid" "e2a76a89 b5ff 46f1 bf4d 494579d7bb71", "ownercustomerid" "83454c7a e5d3 4f3a 8633 11dd49389de2", "status" "active", "ownertitle" "ceo", "partnerid" "0497b3ba ab2f 4537 8257 4af39d7a5cf7", "createdat" "2024 01 07t08 13 08 464z", "lastmodifiedat" "2024 01 07t08 13 08 464z", }