Testing and troubleshooting

Every submission to your form gets a result in your account. Here is how to send a test, read the results and fix the usual refusals.

Send a test

The quickest test is Send test submission on your FormRoute home page. To test from a terminal, send the same request with cURL, using your site key and your field names:

Terminal

curl -X POST 'https://form-route.com/api/v1/send' \
  -H 'Content-Type: application/json' \
  -d '{
    "siteKey": "fr_your_site_key",
    "t": 3000,
    "name": "FormRoute test",
    "email": "[email protected]",
    "message": "This is a FormRoute test submission."
  }'

A cURL request has no Origin header, so it skips the allowed-websites check; everything else is checked as usual. The response is {"message":"sent","id":"…"} when it worked.

Reading results

Recent submissions on your home page lists each submission with its time and result. A sent submission then shows its delivery status as Amazon SES reports it: delivered, delayed, bounced or complained.

Common refusals

Result	What to do
Rejected: website not allowed	Add the exact address of the page to Allowed websites: scheme, host and port. `https://example.com` and `https://www.example.com` are different websites.
Rejected: invalid fields	A required field was empty or a value was too long. Check that each input's `name` matches the field names in your form settings.
CAPTCHA required	Send `t`, the milliseconds since the form was shown. If `t` is missing or under 1200, the submission is treated as automated. Start the clock when the form appears, not when the visitor clicks Send.
Filtered as spam	The `hp` field had a value. Make sure the honeypot input is empty and hidden, and that browser autofill can't reach it (`autocomplete="off"`, `tabindex="-1"`).
Rate limited	Too many submissions in a short time: 20 a minute per visitor, 8 per visitor to one form, 300 an hour per form. Wait a minute while you test.
Not sent: account cannot deliver	The subscription is not active or the domain is not verified. Your account's Billing and Overview pages show which.
Form disabled	The form is switched off. Turn it back on in the form's settings.

The full list of responses is in the Send API reference.

Sent, but not in the inbox

Check the spam folder of the recipient address, and whether a mail rule moved the message.
Look at the delivery status. Bounced means the recipient's mail server refused it; check the recipient address in your form settings.
Still stuck? Write to [email protected] with the time of the submission. Never send passwords or keys.