conecto. Get started
Connections

Call a connected system

connect_call · Changes data · Markdown

Sends one request to a connected system, inside its allowed calls, and returns its answer.

$0.0003 when it answers within 10 seconds

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

An example

Look up ticket 4123 in the old help desk.

Your agent callsconnect_call$0.0003 when it answers within 10 seconds

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "connection": "zendesk",
  "method": "GET",
  "path": "/tickets/4123.json"
}
What comes back
{
  "connection": "zendesk",
  "status": 200,
  "content_type": "application/json",
  "body": {
    "ticket": {
      "id": 4123,
      "subject": "Where is my combi steamer?",
      "status": "open",
      "requester_id": 9021,
      "updated_at": "2026-10-13T16:02:11Z"
    }
  }
}

Use it when

The agent needs data from, or a change in, a connected system.

  • For records Conecto keeps itself, like contacts or invoices, use account_search.

What it does

Send one request to a connected system, inside its allowed calls: method, path (after the base address), query and a JSON body. Answers with the status, the content type and the body (JSON when it is JSON), up to 1 MB. Writes wait for the owner's approval by default (connect_preview shows what would be sent). A call to a system behind the firewall goes to the company's bridge: it answers 202 with a call_id, and account_get_call has the answer once the bridge sends it, usually within seconds. The first 10,000 calls a month are free, then $0.0003 for each started 10 seconds the system takes to answer, at most $0.0012; a call through a bridge is $0.0003.

What comes back

connection; status, the HTTP status; content_type; body, parsed JSON or text (up to 1 MB). Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
connectionRequiredstringThe connection's name. 2 to 40 characters.
methodRequiredstringOne of: GET,POST,PUT,PATCH,DELETE.
pathRequiredstring1 to 500 characters.
queryobject
bodyanyA JSON body for POST, PUT and PATCH.

The call

Over MCP, call connect_call on https://api.conecto.chat/mcp/connect. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/connect_call \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"connection":"zendesk","method":"GET","path":"/tickets/4123.json"}'

When it refuses

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

CodeWhenWhat to do
not_found404No connection has that name.connect_list shows them.
not_allowed403The call is outside the connection's allowed calls.Use an allowed call, or ask the owner to widen them.
too_large413The answer is over 1 MB.Ask for a page or a filter.
vendor_unavailable502The system could not be reached.Try again in a minute.
invalid_input400The method or path is not valid.A path starts with / and holds no query.
bridge_offline503The system is behind the firewall and its bridge is offline.Ask the company's IT to start the bridge.
bridge_unavailable409The bridge was revoked, or no longer serves the system.Ask the owner to make a new bridge and connect the system again.

More Connections tools

All 6 tools

Give this to your agent.

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