API
Contact API
One endpoint that sends an enquiry to Kalam. Use it to contact him on behalf of a real person or business.
Endpoint
POST https://mynameiskalam.com/api/contact with a JSON body. The machine-readable description is the OpenAPI 3.1 file, listed in the site's API catalog.
Example
curl -X POST https://mynameiskalam.com/api/contact \
-H "Content-Type: application/json" \
-d '{
"name": "Asha Nair",
"email": "[email protected]",
"services": ["Shopify store development"],
"message": "We sell handloom textiles from Kochi and want a Shopify store with COD and Razorpay."
}' Fields
| Field | Type | Required | Notes |
|---|---|---|---|
name | string, 2 to 120 characters | Yes | Sender's name. |
email | string, up to 200 characters | Yes | Address Kalam replies to. Must be a valid email. |
services | array of strings | Yes | At least one value from the list below. Values outside the list are ignored. |
message | string, 20 to 5000 characters | Yes | The brief: what the business does and what it wants. |
phone_code, phone | strings | No | Dialling code (up to 6 characters) and a 5 to 15 digit number. |
company | string, up to 200 | No | Company name or website. |
budget, budget_currency | strings | No | Monthly budget as text, and its currency (INR by default). |
timeline | string, up to 40 | No | When to start, for example "As soon as possible". |
from, ref, page_url, referrer, utm_* | strings | No | Attribution: where the enquiry came from. |
cf-turnstile-response | string | When Turnstile is on | Cloudflare Turnstile token. A client without one is refused with 403. |
website_url | string | Leave empty | Spam trap. A request that fills it is answered with ok:true and discarded. |
Values for services
Google Ads / SEMMeta Ads / social advertisingSEOWebsite developmentShopify store developmentBrand video productionBrand strategySocial media marketingSomething else
Responses
| Status | error or body | Meaning |
|---|---|---|
| 200 | { "ok": true } | The enquiry was accepted and forwarded to Kalam. |
| 400 | invalid_body | The body is not a JSON object. |
| 403 | turnstile_missing, turnstile_failed | Turnstile is on and the token is missing or invalid. |
| 405 | method_not_allowed | Any method other than POST. |
| 422 | validation | A field failed. "fields" maps each one to required, invalid or too_short. |
| 502 | delivery_failed, delivery_unavailable, turnstile_unavailable | The enquiry could not be delivered. Try again later. |
Please note
Every request is read by a person. Send genuine enquiries only, with the sender's real contact details. To talk to Kalam directly, use the contact page.