BizKitHub
DocsInteractive API Docs/api/v1/support/contact-form
post

/api/v1/support/contact-form

Creates a support ticket from a contact form submission. Includes anti-spam geolocation check. Optionally registers the customer as a contact.

Endpoint Info
Base URLapi.bizkithub.com
AuthBearer Token
Methods1
Authentication Required

This endpoint requires a valid API key passed as a query parameter or Bearer token.

Get your API key

Parameters

1 query, 9 body parameters

apiKeystringrequired

Your BizKitHub API key (passed as GET parameter).

Key format: A 32-character string matching: ^(PROD|DEV_|ROOT)[A-Za-z0-9]{28}$
Prefixes: PROD (production key), DEV_ (individual developer), ROOT (system key with no limits). Learn more

messagestringrequired

Message body from the customer.

subjectstring

Subject line for the support ticket.

noticestring

Internal note (not visible to customer).

sendToEmailstring

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.

categorySlugstring

Category slug for routing the ticket.

customerEmailstring

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.

customerPhonestring

Contact phone number in international (national) format.

Preferred format: +<country_code> <local_number>

  • Leading plus sign (+) is required
  • Followed by the country calling code (e.g. 420)
  • One space after the country code
  • Full local number without spaces

Example: +420 777123456
This format ensures unambiguous storage, validation, and compatibility with SMS, calling, and third-party integrations (e.g. Twilio, WhatsApp, CRM systems).

customerFirstNamestring
customerLastNamestring

Example Request

JavaScript fetch

const response = await fetch("https://api.bizkithub.com/api/v1/support/contact-form?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "message": "Hello, how are you?",
    "subject": "Request from Jan",
    "notice": "Internal notice",
    "sendToEmail": "jan@barasek.com",
    "categorySlug": "offer",
    "customerEmail": "jan@barasek.com",
    "customerPhone": "+420 777123456",
    "customerFirstName": "Jan",
    "customerLastName": "Barášek"
  })
});

const data = await response.json();
console.log(data);
post

Example Response

200Success
{
  "success": true
}

cURL

Command line example

curl -X POST "https://api.bizkithub.com/api/v1/support/contact-form?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE" \
  -H "Content-Type: application/json" \
  -d '{
  "message": "Hello, how are you?",
  "subject": "Request from Jan",
  "notice": "Internal notice",
  "sendToEmail": "jan@barasek.com",
  "categorySlug": "offer",
  "customerEmail": "jan@barasek.com",
  "customerPhone": "+420 777123456",
  "customerFirstName": "Jan",
  "customerLastName": "Barášek"
}'

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key
Back to API DocumentationAPI Reference