Forms

Get a response

forms_get_response · Reads only · Markdown

One response by its response_id, with every answer readable.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

Open the ride club sign-up from Marcus Webb.

Your agent callsforms_get_responseFree*

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

{
  "response_id": "5be644f8-5b32-4c43-9134-cf68bb2c948a"
}

What comes back

{
  "response": {
    "response_id": "5be644f8-5b32-4c43-9134-cf68bb2c948a",
    "submitted_at": "2026-10-14T08:00:00+00:00",
    "answers": [
      {
        "field_id": "full_name",
        "question": "Your name",
        "type": "short_text",
        "value": "Marcus Webb",
        "answer": "Marcus Webb"
      },
      {
        "field_id": "email",
        "question": "Email",
        "type": "email",
        "value": "marcus.webb@example.com",
        "answer": "marcus.webb@example.com"
      }
    ],
    "hidden": {},
    "contact_id": 4101,
    "form_id": "51414dab-4209-457e-95d1-524478971f37",
    "form_title": "Join the ride club",
    "user_agent": null
  }
}

Use it when

One person's answers matter: an application to review, a complaint to follow up.

What comes back

The response with its form, time, answers (question, stored value, readable answer), link values and CRM contact. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`response_id`Required	string	32 to 36 characters.

The call

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

Terminal

curl -X POST https://api.conecto.chat/v1/tools/forms_get_response \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"response_id":"5be644f8-5b32-4c43-9134-cf68bb2c948a"}'

When it refuses

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

Code	When	What to do
`not_found`404	No response of the business has that response_id.	Find it with forms_list_responses and use its response_id.

More Forms tools

All 12 tools

Give this to your agent.

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

Get a response

An example

Use it when

What comes back

Inputs

The call

When it refuses

More Forms tools

Give this to your agent.