Skip to main content

Send Email Website (v1)

Method & Path

POST /api/v1/send-email-website

Actual path: /v1/send-email-website

Description

Public endpoint for the Placio website contact form. Receives name, email, mobile, and message, then forwards them as a support ticket to service@placio.app via SendGrid.

Authentication

None - Public endpoint.

Headers

HeaderRequiredDescription
Content-TypeYesapplication/json

Request Body

FieldTypeRequiredDescription
namestringYesSender name (max 200 chars)
emailstringYesSender email address
mobilestringNoSender mobile/phone (max 50)
helpMessagestringYesMessage content (max 5000 chars)
{
"name": "John Doe",
"email": "john@example.com",
"mobile": "+972501234567",
"helpMessage": "I would like to learn more about Placio pricing."
}

Response 200 OK

{
"message": "Your message has been sent successfully. We will get back to you soon."
}

Common Errors

  • 400 Validation failed: Invalid or missing fields (name, email, helpMessage)
  • 422 Validation failed: Field validation errors (detailed in response body)
  • 500 EMAIL_SEND_FAILED: SendGrid failed to send the email
  • 503 SERVICE_UNAVAILABLE: SENDGRID_API_KEY not configured