Setu Public API Documentation

// Success
{
  "success": true,
  "data": { ... },
  "meta": {
    "request_id": "req_abc123def456",
    "rate_limit": {
      "limit": 60,
      "remaining": 42,
      "reset": 60
    }
  }
}

// Error
{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid",
    "status": 401
  }
}

curl -X GET https://setu.theabhipatel.com/api/v1/conversations \
  -H "Authorization: Bearer tap_setu_a3f8b1c9d4e7f2a0b5c8d1e4f7a0b3c6d9e2f5a8"

X-RateLimit-Limit: 60       # Max requests per minute
X-RateLimit-Remaining: 42  # Remaining in current window
X-RateLimit-Reset: 60      # Seconds until window resets

curl -X POST https://setu.theabhipatel.com/api/v1/messages/send \
  -H "Authorization: Bearer tap_setu_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_id": "550e8400-e29b-41d4-a716-446655440000",
    "content": "Hello from the API!",
    "message_type": "text"
  }'

{
  "success": true,
  "data": {
    "id": "msg_uuid",
    "conversation_id": "550e8400-...",
    "sender_id": "user_uuid",
    "content": "Hello from the API!",
    "message_type": "text",
    "created_at": "2026-04-26T12:00:00Z"
  }
}

curl https://setu.theabhipatel.com/api/v1/conversations \
  -H "Authorization: Bearer tap_setu_your_key_here"

curl "https://setu.theabhipatel.com/api/v1/users/search?q=john" \
  -H "Authorization: Bearer tap_setu_your_key_here"

curl -X POST https://setu.theabhipatel.com/api/v1/files/upload \
  -H "Authorization: Bearer tap_setu_your_key_here" \
  -F "file=@photo.jpg" \
  -F "conversation_id=550e8400-e29b-41d4-a716-446655440000"

curl https://setu.theabhipatel.com/api/v1/account \
  -H "Authorization: Bearer tap_setu_your_key_here"

{
  "success": true,
  "data": {
    "id": "user_uuid",
    "email": "you@example.com",
    "username": "johndoe",
    "first_name": "John",
    "last_name": "Doe",
    "plan": "free",
    "created_at": "2026-01-15T08:00:00Z"
  }
}

{
  "event": "message.received",
  "timestamp": "2026-04-26T15:00:00Z",
  "data": {
    "conversation_id": "uuid",
    "message_id": "uuid",
    "sender_id": "uuid",
    "content_preview": "Hey, how are...",
    "message_type": "text",
    "created_at": "2026-04-26T15:00:00Z"
  }
}

Content-Type: application/json
X-Setu-Signature: sha256=<HMAC-SHA256 of body using webhook secret>
X-Setu-Event: message.received
X-Setu-Delivery-Id: dlv_uuid_here
X-Setu-Timestamp: 1714150800

const crypto = require('crypto');

function verifyWebhookSignature(body, signature, secret) {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(body)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}