Forms

Change a form

forms_update · Changes data · Markdown

Changes a form's fields or settings; only what you pass changes.

$0.01 a call

From your agent’s balance. A call that fails costs nothing.

Change the ride club form's thank-you note to say Luis replies within two days.

Your agent callsforms_update$0.01 a call

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments

{
  "form": "join-the-ride-club",
  "thank_you_message": "Thank you! Luis reads every sign-up within two days."
}

What comes back

{
  "form": {
    "form_id": "53e172d5-b11c-43f0-9843-3be2a930257c",
    "slug": "join-the-ride-club",
    "url": "https://cncto.co/f/join-the-ride-club",
    "title": "Join the ride club",
    "status": "open",
    "accepting_responses": true,
    "closed_reason": null,
    "responses": 1,
    "last_response_at": "2026-10-14T08:00:00+00:00",
    "created_at": "2026-10-14T08:00:00+00:00",
    "description": "10% off service, and a group ride from the shop every Saturday morning.",
    "fields": [
      {
        "id": "full_name",
        "type": "short_text",
        "label": "Your name",
        "help": "",
        "required": true,
        "placeholder": "",
        "show_if": null
      },
      {
        "id": "email",
        "type": "email",
        "label": "Email",
        "help": "",
        "required": true,
        "placeholder": "",
        "show_if": null
      }
    ],
    "removed_fields": [],
    "submit_label": "Submit",
    "thank_you": {
      "title": "Thank you!",
      "message": "Thank you! Luis reads every sign-up within two days.",
      "redirect_url": null
    },
    "close_at": null,
    "max_responses": null,
    "notify_email": null,
    "save_to_crm": true,
    "confirm_to_respondent": false,
    "on_response": [],
    "hidden_fields": [],
    "updated_at": "2026-10-14T08:00:00+00:00"
  }
}

Use it when

A question, the thank-you words, a closing date or the notification address changes, or each response should confirm to the respondent, open a ticket, make a deal or add a table row.

What it does

Change a form's fields or settings; only what you pass changes. fields replaces the whole list: pass each existing field's id (forms_get shows them) so its answers stay attached, even when you rename it. Answers to fields or options you remove stay readable in responses, exports and summaries. A field that already has answers keeps its type (short_text and long_text may switch). Empty or null clears redirect_url, close_at and notify_email; max_responses 0 or null removes the limit.

What comes back

The form as it now is, with notes when something needs a look. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`form`Required	string	The form's form_id or slug (forms_list shows both). 1 to 60 characters.
`title`	string	1 to 200 characters.
`fields`	array of objects	The questions in order. When changing a form, this replaces the whole list. 1 to 100 items.
`fields[].id`	string	Stable id; answers are keyed by it. Generated from the label when left out. Pass it back when you change the form, or a renamed field becomes a new one. Matches ^[a-z0-9_]{1,40}$.
`fields[].type`Required	string	One of: short_text,long_text,email,phone,url,number,choice,multi_choice,rating,nps,date,yes_no,consent,statement.
`fields[].label`	string	The question. A statement's label is the text it shows. A consent label may hold one link: "I agree to the [terms](https://acme.com/terms)". Up to 1,000 characters.
`fields[].help`	string	Smaller text under the question. Up to 2,000 characters.
`fields[].include_time`	boolean	date: a time too (answers like 2026-11-03T09:30).
`fields[].range`	boolean	date: a first and a last day (2026-11-03/2026-11-07).
`fields[].earliest`	string or null	date: the first day that can be picked: "2026-11-01", "today", "today+1". Up to 20 characters.
`fields[].latest`	string or null	date: the last day that can be picked: "2026-12-31", "today+60", "today". Up to 20 characters.
`fields[].required`	boolean	Default: false.
`fields[].placeholder`	string	short_text, long_text, email, phone, url and number only. Up to 200 characters.
`fields[].default_country`	string or null	phone: the country of numbers typed without a +, like "US". Exactly 2 characters.
`fields[].min`	number or null	number: the smallest answer.
`fields[].max`	number or null	number: the largest answer.
`fields[].integer`	boolean	number: whole numbers only.
`fields[].options`	array of string or object	choice and multi_choice: ["Basic", "Pro"], or [{"id": "basic", "label": "Basic"}] to keep ids stable when you rename an option. 1 to 100 items.
`fields[].min_selections`	integer or null	multi_choice: the fewest options. At least 1.
`fields[].max_selections`	integer or null	multi_choice: the most options. At least 1.
`fields[].scale`	integer	rating: 3 to 10 (default 5). 3 to 10.
`fields[].low_label`	string	rating and nps: words under the lowest score. Up to 60 characters.
`fields[].high_label`	string	rating and nps: words under the top score. Up to 60 characters.
`fields[].show_if`	object or null	Show this field only when an earlier field has this answer (for multi_choice: when that option is among the choices). A hidden field is never required.
`fields[].show_if.field`Required	string	An earlier field's id.
`fields[].show_if.equals`Required	any	The answer that shows the field: an option id (choice, multi_choice), true or false (yes_no, consent), a number (number, rating, nps), a date (date) or text (short_text, email).
`description`	string	Shown under the title. Up to 2,000 characters.
`submit_label`	string	The button's words (default "Submit"). 1 to 40 characters.
`thank_you_title`	string	Shown after sending (default "Thank you"). 1 to 120 characters.
`thank_you_message`	string	Up to 1,000 characters.
`redirect_url`	string or null	An https:// page to send people to after they submit. Empty or null: none. Up to 2,000 characters.
`close_at`	string or null	Stop taking responses at this time (ISO 8601, like 2026-12-31T23:59:00Z; UTC when no offset is given). Empty or null: never. Up to 40 characters.
`max_responses`	integer or null	Stop after this many responses. 0 or null: no limit. 0 to 1,000,000.
`notify_email`	string or null	Email this address about new responses: at most one email a minute per form, later responses grouped into the next one. Free credit can only notify the owner's email. Empty or null: off. Up to 254 characters.
`confirm_to_respondent`	boolean	Email each respondent their answers in the brand kit (form_confirmation wording), to the address they typed in the first email field. $0.002 each; paid accounts only; at most three a day to one address.
`on_response`	array of objects	What each response also does on its own, while you are away ($0.01 per action done): {"action": "open_ticket", "priority": "normal"} opens a help desk ticket for the respondent; {"action": "create_deal", "pipeline": "Sales", "stage": "New", "amount_field": "budget"} creates a deal with them as contact; {"action": "add_row", "table": "Leads", "columns": {"Email": "email", "Budget": "budget"}} adds a row, each column from a field id. [] or null: none. Up to 3 items.
`on_response[].action`Required	string	One of: open_ticket,create_deal,add_row.
`on_response[].priority`	string	One of: low,normal,high,urgent.
`on_response[].pipeline`	string	Up to 80 characters.
`on_response[].stage`	string	Up to 80 characters.
`on_response[].amount_field`	string	Up to 40 characters.
`on_response[].table`	string	Up to 80 characters.
`on_response[].columns`	object
`save_to_crm`	boolean	Save the person behind each response as a CRM contact. The first email field is the email; a short_text field with id name or full_name (or first_name and last_name) is the name; the first phone field the phone. An existing contact only gets empty fields filled.
`hidden_fields`	array of strings	Link values kept with each response: ["ref", "utm_source"] keeps them from https://cncto.co/f/<slug>?ref=abc&utm_source=newsletter. Up to 10 items.

The call

Over MCP, call forms_update on https://api.conecto.chat/mcp/forms. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/forms_update \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"form":"join-the-ride-club","thank_you_message":"Thank you! Luis reads every sign-up within two days."}'

When it refuses

A refused call costs nothing and says what to do next.

Code	When	What to do
`not_found`404	No form of the business has that form_id or slug.	Call forms_list and use a form_id or slug from it.
`invalid_input`400	A field or setting is not valid: a field type that does not take an option, a missing list of options, a show_if on a later field, a close_at in the past, or save_to_crm without an email field.	Fix what the message names; it points at the field by its place, like fields[2].
`payment_required_for_outbound`402	notify_email is not the owner's email, and the balance is still free credit.	Notify the owner's email, or top up once (POST /v1/topups).
`invalid_input`400	Nothing to change was given.	Pass the fields or settings to change.

More Forms tools

All 12 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md

Change a form

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Forms tools

Give this to your agent.