Skip to main content

Create Blockwyre Account

Overview​

Before initiating any verification process (KYC or KYB), you must first create a Blockwyre account. The same endpoint is used for both individual and business accounts — the accountType field determines which type is created.

After creating an account, proceed to the appropriate verification guide:

Endpoint​

Endpoint: POST /api/v2/accounts

Authentication:

  • Bearer token (JWT) required
  • Permissions: accounts:create or accounts:manage

Request Parameters​

Required Parameters:

  • accountName: Full name of the user's account (individual) or registered legal name of the company (business).
  • accountType: Account type. Use individual for personal accounts or business for business accounts.
  • email: Email address of the user or business contact email.
  • firstName: First name of the user or primary business contact.
  • lastName: Last name of the user or primary business contact.

Optional Parameters:

  • accountId: Pre-assigned UUID for the account. If not provided, one will be auto-generated.
  • reference: Custom reference identifier for the account. If not provided, a UUID will be auto-generated.

Examples​

Individual Account​

Request:

{
  "email": "john@example.com",
  "accountName": "John Account",
  "accountType": "individual",
  "firstName": "John",
  "lastName": "Wick",
  "reference": "client-123"
}

Response (201 Created):

{
  "id": "019f1234-5678-90ab-cdef-1234567890ab",
  "reference": "client-123",
  "accountType": "individual",
  "email": "john@example.com",
  "accountName": "John Account",
  "firstName": "John",
  "lastName": "Wick",
  "status": "pending",
  "createdAt": "2026-02-16T00:00:00Z",
  "updatedAt": "2026-02-16T00:00:00Z"
}

Business Account​

Request:

{
  "accountName": "Example Corp LLC",
  "accountType": "business",
  "email": "admin@examplecorp.com",
  "firstName": "John",
  "lastName": "Doe",
  "reference": "business-client-456"
}

Response (201 Created):

{
  "id": "019f1234-5678-90ab-cdef-1234567890ab",
  "reference": "business-client-456",
  "accountType": "business",
  "email": "admin@examplecorp.com",
  "accountName": "Example Corp LLC",
  "firstName": "John",
  "lastName": "Doe",
  "status": "pending",
  "createdAt": "2026-02-16T00:00:00Z",
  "updatedAt": "2026-02-16T00:00:00Z"
}

Error Responses​

  • 400 Bad Request: Invalid request format
  • 409 Conflict: Account with this email or reference already exists
  • 422 Unprocessable Entity: Validation errors (missing required fields, invalid format)

Next Steps​

Once the account is created with status: "pending", proceed to the verification process:

  • Individual accounts: Follow the KYC Guide to submit identity verification data.
  • Business accounts: Follow the KYB Guide to submit business verification data, corporate documents, and ownership information.

Support and Resources​

If you need assistance or have any questions, our support team is here to help. You can contact our support team at support@blockwyre.com.

Stay Updated​

Stay up-to-date with the latest news, updates, and features from BlockWyre by following us on social media:

We are excited to have you on board and look forward to seeing how you leverage BlockWyre's powerful tools to enhance your financial operations. Happy integrating!