IW IT WALK
Developer docs

IT WALK Email API

Send email over a simple REST API. Base URL: https://itwalk.in/api/index.php

๐Ÿงช Interactive Swagger reference

Getting started

Log in to your account, open Email API and create a key. You'll get a public key and a secret (shown once). Then call the API with both as headers.

Authentication

Send both headers on every request:

headers
X-Itwalk-Key:    <your public key>
X-Itwalk-Secret: <your secret>

Send email โ€” POST /mail-api/send

FieldReqDescription
toyesRecipient email
subjectyesSubject line
html / textyes*Body โ€” provide html and/or text
to_name, from_email, from_name, reply_tonoOptional sender/recipient details
send.sh
curl -X POST 'https://itwalk.in/api/index.php/mail-api/send' \
  -H 'Content-Type: application/json' \
  -H 'X-Itwalk-Key: <key>' -H 'X-Itwalk-Secret: <secret>' \
  -d '{ "to":"user@example.com", "subject":"Hello", "html":"<p>Hi</p>" }'

// 200 โ†’ { "status":"success", "message_id":"a1b2c3...", "delivery_server_id":5 }

Message status โ€” GET /mail-api/status?message_id=โ€ฆ

Returns the handoff status of a message you sent (scoped to your account).

status
curl 'https://itwalk.in/api/index.php/mail-api/status?message_id=a1b2c3' \
  -H 'X-Itwalk-Key: <key>' -H 'X-Itwalk-Secret: <secret>'

Logs โ€” GET /mail-api/logs

List recent sends. Query params: limit (1โ€“100), page, status (sent/failed).

HTTP status codes

CodeMeaning
200Success
401Missing / invalid credentials
422Validation error
429Rate limit / quota exceeded
502Delivery server failed
503No delivery server available

Prefer clicking around? Open the interactive Swagger reference and hit โ€œTry it outโ€.

Build with the API

Create an account, generate a key, and send your first email.

Get your API key