Skip to main content

Create a corporate identity

To start the onboarding flow, register a corporate by providing the company and rootUser information.

The rootUser must be a legal representative of the corporate such as a director or someone with power of attorney over the company. The root userRoot user The individual who creates the identity. For corporate identities, the root user needs to be a legal representative of the corporate such as a director or a representative who has the power of attorney over the company. For consumer identities, the root user is the owner of the identity. Every identity must always have one root user. is always assigned the Admin role, which grants full access to the identity including the ability to invite and manage other users. For more on the root userRoot user The individual who creates the identity. For corporate identities, the root user needs to be a legal representative of the corporate such as a director or a representative who has the power of attorney over the company. For consumer identities, the root user is the owner of the identity. Every identity must always have one root user. concept, see Root user.

Your API key

You can find your API key in the Weavr Portal. Learn more about authentication and how to obtain your API key here.

POST/corporatesTry it 
{
  "profileId": "string",
  "tag": "string",
  "rootUser": {
    "name": "string",
    "surname": "string",
    "email": "[email protected]",
    "mobile": {
      "countryCode": "stri",
      "number": "string"
    },
    "companyPosition": "DIRECTOR",
    "dateOfBirth": {
      "year": 1900,
      "month": 1,
      "day": 1
    },
    "tag": "string"
  },
  "company": {
    "type": "SOLE_TRADER",
    "businessAddress": {
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "postCode": "string",
      "state": "string",
      "country": "st"
    },
    "name": "string",
    "registrationNumber": "string",
    "registrationCountry": "st"
  },
  "industry": "ACCOUNTING",
  "sourceOfFunds": "LABOUR_CONTRACT",
  "sourceOfFundsOther": "string",
  "acceptedTerms": true,
  "ipAddress": "string",
  "baseCurrency": "str",
  "feeGroup": "string"
}

The response is the corporate object that contains the information you provided together with the id, which is used to identify this particular corporate in subsequent API calls. The response also includes the root userRoot user The individual who creates the identity. For corporate identities, the root user needs to be a legal representative of the corporate such as a director or a representative who has the power of attorney over the company. For consumer identities, the root user is the owner of the identity. Every identity must always have one root user.'s id.

Next steps​

With the corporate registered, the root userRoot user The individual who creates the identity. For corporate identities, the root user needs to be a legal representative of the corporate such as a director or a representative who has the power of attorney over the company. For consumer identities, the root user is the owner of the identity. Every identity must always have one root user. is created but not yet usable. To activate the corporate:

  1. Set up the root user - set their password, verify their email, and enroll an authentication factor.
  2. Complete KYB - submit due diligence information so the corporate can be verified.