Skip to main content
Use this endpoint to submit answers to a Plato form.
POST /api/public/forms/[slug]
This endpoint currently expects the API key in the query string.

Example

curl "https://api.plato.ae/api/public/forms/contact-us?apiKey=$PLATO_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Customer",
    "email": "[email protected]",
    "message": "I would like to learn more."
  }'

Body

Send a JSON object where each key matches a form field ref.
{
  "email": "[email protected]",
  "message": "I would like to learn more."
}

Response

{
  "message": "Submited form successfully."
}

What Happens After Submit

Plato:
  1. Finds the form by slug in the API key workspace.
  2. Stores the response.
  3. Creates a workspace notification.
  4. Sends configured form response email notifications.

Not Found

If the form is disabled or the slug does not belong to the workspace, Plato returns:
{
  "message": "Form not found."
}
with status 404.

Security

Submit form responses from a backend when possible. If a public website must submit directly, use a short-lived or tightly scoped key and monitor usage.