createAccount

POST /api/account/createAccount/{countryId}

Creates a company account. It is asynchronous: returns a trackId to check the final status with getProcess.

SBXhttps://gosocket-onboarding-api-sbx.gosocket.net/api/account/createAccount/{countryId}

PRDhttps://global-apim-prd.gosocket.net/ms-onboardingapi/api/account/createAccount/{countryId}

Internal Microprocesses

#	Action
1	Company account creation
2	Administrator user creation
3	Digital certificate upload (if applicable)
4	ApiKey generation (OAuth 2.0 or Basic Auth)

Behavior based on object existence

The process behaves differently depending on whether the account, user, or certificate already exist in the system. The API detects each case automatically:

Account	User	Certificate	Action / Behavior
🆕 New	🆕 New	🆕 New	Initial Setup: creates account → assigns admin user → uploads certificate → generates ApiKeys
✅ Exists	🆕 New	🆕 New	User Onboarding: creates admin user → uploads certificate
✅ Exists	✅ Exists	🆕 New	Activation: uploads certificate
✅ Exists	✅ Exists	♻️ Renew	Renewal: replaces certificate (new default)
🆕 New	✅ Exists	🆕 New	New Organization: creates account → assigns existing user as admin → uploads certificate
✅ Exists	🆕 New	♻️ Renew	Additional Admin: creates admin user → replaces certificate (new default)

Path Parameters

Field	Type	Req.	Description
countryId	string	Required	ISO country code (e.g.: ar, cl, mx)

Body — complete structure

Field	Type	Req.	Description
accountUser.account.code	string	Required	Company TaxId / RUT
accountUser.account.name	string	Required	Company name
accountUser.account.description	string	Optional	Free description
accountUser.account.address	string	Optional	Address
accountUser.account.city	string	Optional	City
accountUser.account.province	string	Optional	Province / State
accountUser.account.phone	string	Optional	Phone
accountUser.user.name	string	Required	Admin user name
accountUser.user.email	string	Required	Admin user email
accountUser.authenticationMethod	integer	Required	1 = OAuth 2.0 · 0 = Basic Auth
certificateRootDto.certBase64	string	Conditional	.pfx certificate in Base64
certificateRootDto.certKeyBase64	string	Conditional	Private key in Base64 (when applicable)
certificateRootDto.password	string	Conditional	Certificate password
certificateRootDto.defaultCertificate	boolean	Conditional	Sets whether it is the default certificate
taxEntity	object	Conditional	Tax entity data — see Onboarding by Country

createAccount

{
"accountUser": {
  "account": {
    "code": "{{taxId}}",
    "name": "Nombre Organización",
    "description": "",
    "address": "",
    "city": "",
    "province": "",
    "phone": "",
    "fax": ""
  },
  "user": {
    "name": "Nombre Usuario Admin",
    "email": "user@empresa.com"
  },
  "authenticationMethod": 1
},
"certificateRootDto": {
  "certBase64": "BASE64_CERTIFICADO",
  "certKeyBase64": "",
  "password": "PASSWORD_CERT",
  "defaultCertificate": false
}
}