Submissions API

Send submissions directly to Sugarforms with JSON, URL-encoded, or multipart payloads.

Endpoint

POST /api/forms/{formId}/submit

Request Payload

You can send either a top-level values object or plain key/value fields. sourceUrl is optional.

{
  "sourceUrl": "https://example.com/signup",
  "values": {
    "email": "person@example.com",
    "full_name": "Alex Doe"
  }
}

cURL Example

Example JSON submission request:

curl -X POST https://your-domain.com/api/forms/{formId}/submit \
  -H "Content-Type: application/json" \
  -d '{"sourceUrl":"https://example.com","values":{"email":"person@example.com"}}'

Response Notes

Key response outcomes:

201 when submission is accepted.
400 for invalid payload or missing required fields.
403 when the form is not published or the form-level response limit is reached.
429 when the account-level monthly response limit is reached.
404 when the form does not exist.