/api/v1/customer/magic-auth

Create a new customer identity based on e-mail without password. Return identity session value or error code.

List of error codes:

Code	Message
E001	Customer login failed.
E002	Customer e-mail does not exist.
E003	Customer have not a registered account.
E004	Wrong e-mail or password.
E005	Customer account has been banned.
E006	Too many login attempts.
E007	Customer mail has not been authorized.

post

Tags:customer

Operation ID: postApiV1CustomerMagic-auth

Query Parameters

apiKeystring

required

Your BizKitHub API key (passed as GET parameter)

Get API Key →

Body

emailstring

required

Contact email address.

The system validates the input as a standard email address and automatically applies normalization and canonicalization.

All API responses return the normalized form, and each email address is globally unique per contact within the system.

Example: "jan@barasek.com"

firstNamestring

optional

Example: "Jan"

lastNamestring

optional

Example: "Barášek"

customerRealIpstring

optional

Example: "1.1.1.1"

referralIdstring

optional

cuRefNo = customer reference number.

Example: "1cGIHvFoQDGLAbcA"

Responses

200

No description

Base URL:

https://bizkithub.com

Example Request

fetch('https://bizkithub.com/api/v1/customer/magic-auth?apiKey=YOUR_API_KEY', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
        "email": "jan@barasek.com",
        "firstName": "Jan",
        "lastName": "Barášek",
        "customerRealIp": "1.1.1.1",
        "referralId": "1cGIHvFoQDGLAbcA"
    })
})

Example Response

HTTP 200Success Response

{
  "success": true,
  "data": {
    "message": "Example response"
  }
}

🔑 API Key Required

All BizKitHub API endpoints require authentication using an API key. The API key must be passed as a GET parameter in the URL for all requests.

Get API Key →API Overview →

Back to API Documentation

Last updated: January 2, 2026