Reach out

Accept customer contact form submissions from your website. Each submission creates an inquiry in EquityPOS and notifies users with Support or admin access.

POST/reach-out

Request body (JSON)

json

{
  "topic": "Pricing",
  "subject": "Bulk order for resort",
  "message": "We need 200 units delivered by July. Please share a quote.",
  "email": "guest@example.com",
  "phone": "+960 123 4567",
  "name": "Aisha Hassan",
  "productPhotoUrl": "https://example.com/uploads/product.jpg"
}

topic, subject, message, email, and phone are required.
name is optional.
productPhotoUrl is optional. When provided, include a public HTTPS image URL from your website so your support team can see the referenced product.
Use the same Authorization: Bearer location API key as other public endpoints.

Response

json

{
  "data": {
    "id": "01H...",
    "topic": "Pricing",
    "subject": "Bulk order for resort",
    "productPhotoUrl": "https://example.com/uploads/product.jpg",
    "createdAt": "2026-05-31T12:00:00.000Z"
  }
}

Returns 201 Created on success. Validation errors return 400 with a details object.

Example

bash

curl -s -X POST https://equitypos.com/api/v1/public/reach-out \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "Support",
    "subject": "Question about delivery",
    "message": "Do you deliver to Hulhumale phase 2?",
    "email": "customer@example.com",
    "phone": "+960 999 1234",
    "productPhotoUrl": "https://example.com/images/item-123.jpg"
  }'

API reference

Reach out

Response

Example