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.

  1. A form in Movo. It decides which questions are asked and where the families land. See Creating a website form.

  2. 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.

  3. 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_YOURFORMKEY

It shows everything your form needs to match:

  • fields lists each question and whether it is required, optional or hidden. You can leave out the hidden ones.

  • fields.questions lists the questions your organization added. Each has an id, like q_9tu7s7. You send its answer under that id.

  • consentText, termsUrl and privacyPolicyUrl are 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/submissions

Here 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-Type is 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

parentFirstName

The parent's first name. Always needed.

parentLastName

The parent's last name.

phone

A US phone number.

email

An email address.

childName

The child's first name.

childLastName

The child's last name.

childAge

A whole number from 0 to 21.

childGrade

One of TK, K, 1st, 2nd and so on up to 12th.

street, unit, city, state

The family's address.

zip

Five digits, or ZIP+4 like 55401-1234.

message

Anything else the parent wants to say, up to 600 characters.

answers

Your own questions, by id. See below.

consent

true if the parent ticked the consent box, false if not.

pageUrl

The page your form is on. Optional.

elapsedMs

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): true or false.

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: true only 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

202

Movo has the answers.

Show your thank-you message.

422

Some answers need a look. fieldErrors has a message for each field, by field name or question id.

Show each message under its field. They are written for the parent.

400

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.

403

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 www.

404

The form is turned off, or the key is not right.

Check the key, and that the form is on.

429

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.