Sending your own form's answers to Movo
Last updated: November 12, 2026
There are two ways to put a Movo form on your website. You can paste in Movo's ready-made form, or you can build your own form and send its answers to Movo. This article covers the second way.
With your own form, you choose the design and can add your own checks. Movo still adds the family and starts the conversation, the same as it does for its own form.
This article is for the person who builds your website.
Before you start
You will need three things.
A form in Movo. It decides which questions are asked and where the families land. See Creating a website form.
Your website on the form's list. Open the form, click Edit form, then the Settings tab, and add your site under Websites. Add every address the form will be on, like your test site and your live site. Movo accepts answers from the sites on this list. See A form's websites, language, consent and legal links.
The form's key. It starts with
wf_and is in the form's install code. See Getting your form's install code.
See what your form asks
Open this address in a browser, with your own key at the end:
https://api.trymovo.ai/api/public/website-forms/wf_YOURFORMKEYIt shows everything your form needs to match:
fieldslists each question and whether it isrequired,optionalorhidden. You can leave out the hidden ones.fields.questionslists the questions your organization added. Each has anid, likeq_9tu7s7. You send its answer under that id.consentText,termsUrlandprivacyPolicyUrlare the consent wording and the legal links for your form to show. There is more on these below.
Send the answers
When the parent sends your form, post the answers from their browser to this address:
https://api.trymovo.ai/api/public/website-forms/wf_YOURFORMKEY/submissionsHere is an example you can copy and change.
const shownAt = Date.now(); // set this when the form appears
async function sendToMovo(answers) {
const res = await fetch(
"https://api.trymovo.ai/api/public/website-forms/wf_YOURFORMKEY/submissions",
{
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
parentFirstName: answers.firstName,
parentLastName: answers.lastName,
phone: answers.phone,
email: answers.email,
childName: answers.childFirstName,
childAge: answers.childAge,
zip: answers.zip,
answers: {
q_9tu7s7: answers.referralCode,
},
consent: answers.consentTicked, // true or false
pageUrl: window.location.origin + window.location.pathname,
elapsedMs: Date.now() - shownAt,
}),
}
);
return res;
}Two things will save you time here:
Send it from the parent's browser, not from your server. Movo limits how often one person can send a form. Everything from a server looks like one person, so it would soon be turned away.
Keep the request simple.
Content-Typeis the only header Movo needs, and it does not use cookies.
The fields
Send the fields your form asks, and leave out the rest. If Movo gets a field it does not recognize, it will not accept the submission.
Field | What to send |
|---|---|
| The parent's first name. Always needed. |
| The parent's last name. |
| A US phone number. |
| An email address. |
| The child's first name. |
| The child's last name. |
| A whole number from 0 to 21. |
| One of |
| The family's address. |
| Five digits, or ZIP+4 like |
| Anything else the parent wants to say, up to 600 characters. |
| Your own questions, by id. See below. |
|
|
| The page your form is on. Optional. |
| How long the parent had the form open, in milliseconds. |
Your own questions
Each answer goes inside answers, under the question's id. What you send depends on the kind of question:
Typed answer (
text): the text, up to 1,000 characters.Pick one (
choice): the option, spelled exactly as it is in the form.Pick any (
multi): a list of options, each spelled exactly, like["I am the parent/guardian (18+)"].Yes or no (
yesno):trueorfalse.
The consent box
Before Movo can text or call a parent, the parent has to agree to it. So your form needs a consent box, with the wording from consentText beside it and links to the Terms and the Privacy Policy.
A few things to get right:
The box starts unticked.
The parent can send the form without ticking it.
Send
consent: trueonly when the parent ticked it.
If the parent leaves it unticked, Movo does not keep their phone number and will reach them by email, so ask for an email address too.
Please use the wording exactly as it is. Phone carriers check it, and they can stop an organization's texts if it has been changed.
Keeping bots out
Movo quietly drops anything that looks like it came from a bot. Two things help it tell a real parent from a bot:
Send
elapsedMs. Start a timer when the form appears and send how long the parent took. If it is missing, or under 2,000 (two seconds), Movo treats the send as a bot.Leave out
website. Movo's own form uses a hidden box with that name to catch bots, so a value there is treated as a bot.
A bot gets the same "received" answer as a real parent, so your form will look like it worked. If families are not showing up in Movo, these two are the first things to check.
One person can send the form five times in fifteen minutes. After that, Movo asks them to try again in a few minutes.
What Movo answers
Answer | What it means | What to do |
|---|---|---|
| Movo has the answers. | Show your thank-you message. |
| Some answers need a look. | Show each message under its field. They are written for the parent. |
| Movo could not read what was sent. This is usually a field it does not recognize, or the wrong kind of value. | Check your field names against the table above. |
| Your site is not on the form's list of websites yet. | Add the site in the form's settings. The address has to match exactly, including |
| The form is turned off, or the key is not right. | Check the key, and that the form is on. |
| This person has sent the form too many times. | Ask them to try again in a few minutes. |
A 422 looks like this:
{
"error": "Some answers need a look",
"code": "invalid_fields",
"fieldErrors": {
"email": "Enter a valid email address",
"q_9tu7s7": "Please answer this question"
}
}Testing your form
There is no test mode, so anything you send is a real submission. When you test, use your own name, phone number and email. You will show up in Movo as a family and get Movo's first message, which is a good way to see what parents will see.
Let your Movo contact know which entries were tests, so they can be tidied up afterwards.
After it is sent
The family shows up in Movo soon after, and Movo sends its first message. If the parent is already a family in Movo, their details stay as they are and they are added to the form's audience. See What happens after a family sends your form.
Every send is listed on the form's page in Movo. See Seeing a form's submissions.
If you would like a copy of each one sent back to your own system, see Sending form submissions to your CRM or Google Analytics.
Need a hand?
If something is not working, email support@trymovo.ai with your form's key and the answer Movo gave you. We are happy to help.