Create a corporate

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 userThe individual who creates the customer. For corporates, the root user needs to be a legal representative of the company, such as a director or someone with power of attorney. For consumers, the root user is the customer. Every customer must always have one root user. is always assigned the Admin role, which grants full access to the customer including the ability to invite and manage other users. For more on the root userRoot userThe individual who creates the customer. For corporates, the root user needs to be a legal representative of the company, such as a director or someone with power of attorney. For consumers, the root user is the customer. Every customer must always have one root user. concept, see Root user.

Your API key

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

POST/corporatesOpen API reference →

/corporates

{  "profileId": "10001",  "tag": "customer-123",  "rootUser": {    "name": "string",    "surname": "string",    "email": "[email protected]",    "mobile": {      "countryCode": "+44",      "number": "7700900123"    },    "companyPosition": "DIRECTOR",    "dateOfBirth": {      "year": 1990,      "month": 1,      "day": 1    },    "tag": "customer-123",    "locale": "en-GB",    "brand": "Acme"  },  "company": {    "type": "SOLE_TRADER",    "businessAddress": {      "addressLine1": "1 High Street",      "addressLine2": "Flat 2",      "city": "London",      "postCode": "W1A 1AA",      "state": "Greater London",      "country": "GB"    },    "name": "string",    "registrationNumber": "string",    "registrationCountry": "string"  },  "industry": "ACCOUNTING",  "sourceOfFunds": "LABOUR_CONTRACT",  "sourceOfFundsOther": "string",  "acceptedTerms": true,  "ipAddress": "string",  "baseCurrency": "GBP",  "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 userThe individual who creates the customer. For corporates, the root user needs to be a legal representative of the company, such as a director or someone with power of attorney. For consumers, the root user is the customer. Every customer must always have one root user.'s id.

Next steps

With the corporate registered, the root userRoot userThe individual who creates the customer. For corporates, the root user needs to be a legal representative of the company, such as a director or someone with power of attorney. For consumers, the root user is the customer. Every customer 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.