Make a PowerPoint deck

documents_create_deck · Changes data · Markdown

A PowerPoint deck from your slides, plain or in the business's template, with editable charts, tables and each slide's sources.

$0.10 a call

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

Turn the Kuechentechnik Nord analysis into slides for Thursday's board meeting, in our template.

Your agent callsdocuments_create_deck$0.10 a call

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

{
  "name": "Kuechentechnik Nord, first look.pptx",
  "slides": [
    {
      "type": "title",
      "title": "Kuechentechnik Nord GmbH",
      "subtitle": "A first look for Hansen & Voss",
      "date": "October 2026"
    },
    {
      "type": "kpis",
      "title": "The company in four numbers",
      "items": [
        {
          "label": "Revenue 2025",
          "value": "EUR 18.4m"
        },
        {
          "label": "EBITDA margin",
          "value": "14.1%"
        },
        {
          "label": "Staff",
          "value": "64"
        },
        {
          "label": "Founded",
          "value": "1998"
        }
      ],
      "sources": [
        "Bundesanzeiger, annual accounts 2025"
      ]
    },
    {
      "type": "football_field",
      "title": "Enterprise value (EUR m)",
      "ranges": [
        {
          "method": "DCF",
          "low": 19.8,
          "high": 24.6
        },
        {
          "method": "Trading multiples",
          "low": 18.2,
          "high": 23.9
        }
      ],
      "markers": [
        {
          "label": "Ask",
          "value": 25
        }
      ]
    }
  ]
}

What comes back

{
  "file": {
    "file_id": "a87abbb1-e05d-4e25-87b2-7032371badf2",
    "name": "Kuechentechnik Nord, first look.pptx",
    "content_type": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
    "size": "31.2 KB",
    "size_bytes": 31919,
    "sha256": "8fef02484024486545fc2ecad491e74b0ea2a246ad8215e93d52faef37144a6c",
    "created_at": "2026-10-14T08:00:00+00:00",
    "download_url": "https://cncto.co/d/a87abbb1-e05d-4e25-87b2-7032371badf2?t=eyJmIjoiYTg3YWJiYjEtZTA1ZC00ZTI1LTg3YjItNzAzMjM3MWJhZGYyIiwiZXhwIjoxNzkyODUzODAzfQ:1xKGhH:N81b4ZTbaOR5HwYVsOB9FZmXBYLLFEj15nLYTZ2DcW8",
    "link_expires_in_hours": 24
  },
  "slides": 3
}

Use it when

For a board pack, an outside-in analysis or a market report the business will present.

For a document to read rather than present, use documents_create_pdf.

What it does

A PowerPoint deck from your slides, saved in the file store with a download link (and a PDF with pdf: true): title and section slides, bullet text, big-number KPIs, tables, native charts (bar, column, stacked, line, pie, radar) that stay editable, the football field from valuation_football_field (its deck_block), and images. Each slide can carry its sources, shown under it, and speaker notes. In Conecto's plain board style, or in the business's own template (a .pptx or .potx in the store): its layouts, fonts and colours. You write every word.

What comes back

file (file_id, name, download_url and the rest of a stored file), slides (how many), and pdf, the PDF's file, when pdf is true. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`name`Required	string	Name for the new file, e.g. "Quote 1042.pdf". 1 to 200 characters.
`slides`Required	array of objects	1 to 40 items.
`slides[].type`Required	string	title, section and text slides take words; kpis big numbers; table, chart and football_field figures; image a picture from the file store. One of: title,section,text,kpis,table,chart,football_field,image.
`slides[].title`	string	Up to 160 characters.
`slides[].subtitle`	string	Up to 300 characters.
`slides[].date`	string	Up to 60 characters.
`slides[].bullets`	array of strings	Up to 10 items.
`slides[].items`	array of objects	1 to 6 items.
`slides[].items[].label`Required	string	Up to 80 characters.
`slides[].items[].value`Required	string or number	Up to 24 characters.
`slides[].items[].note`	string	Up to 120 characters.
`slides[].columns`	array of strings	1 to 8 items.
`slides[].rows`	array of arrays	1 to 15 items.
`slides[].chart`	string	One of: bar,column,stacked_column,line,pie,radar. Default: column.
`slides[].categories`	array of string or number	1 to 24 items.
`slides[].series`	array of objects	1 to 6 items.
`slides[].series[].name`Required	string	Up to 60 characters.
`slides[].series[].values`Required	array of number or null	Up to 24 items.
`slides[].format`	string	How table and chart figures read: 1,234 / 14.2% (give 0.142) / 8.5x. One of: number,percent,multiple. Default: number.
`slides[].decimals`	integer	0 to 3. Default: 0.
`slides[].column_formats`	array of strings	A table's format per column, instead of one format for all. Up to 8 items. One of: text,number,percent,multiple.
`slides[].ranges`	array of objects	1 to 12 items.
`slides[].ranges[].method`Required	string	Up to 80 characters.
`slides[].ranges[].low`Required	number
`slides[].ranges[].high`Required	number
`slides[].ranges[].midpoint`	number
`slides[].markers`	array of objects	Up to 5 items.
`slides[].markers[].label`Required	string	Up to 60 characters.
`slides[].markers[].value`Required	number
`slides[].currency`	string	Up to 10 characters.
`slides[].file_id`	string	For an image slide: a PNG or JPEG in the file store. Exactly 36 characters.
`slides[].caption`	string	Up to 200 characters.
`slides[].sources`	array of strings	Shown under the slide: the register, filing or statistic each figure came from. Up to 6 items.
`slides[].notes`	string	Speaker notes. Up to 4,000 characters.
`template_file_id`	string	The business's own PowerPoint template; its sample slides are left out. Exactly 36 characters.
`logo_file_id`	string	A PNG or JPEG logo for the title slide (plain style). Exactly 36 characters.
`accent`	string	The plain style's one colour, e.g. #1E3A8A. Matches ^#?[0-9A-Fa-f]{6}$.
`pdf`	boolean	Default: false.
`link_hours`	integer	1 to 168. Default: 24.

The call

Over MCP, call documents_create_deck on https://api.conecto.chat/mcp/documents. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/documents_create_deck \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Kuechentechnik Nord, first look.pptx","slides":[{"type":"title","title":"Kuechentechnik Nord GmbH","subtitle":"A first look for Hansen & Voss","date":"October 2026"},{"type":"kpis","title":"The company in four numbers","items":[{"label":"Revenue 2025","value":"EUR 18.4m"},{"label":"EBITDA margin","value":"14.1%"},{"label":"Staff","value":"64"},{"label":"Founded","value":"1998"}],"sources":["Bundesanzeiger, annual accounts 2025"]},{"type":"football_field","title":"Enterprise value (EUR m)","ranges":[{"method":"DCF","low":19.8,"high":24.6},{"method":"Trading multiples","low":18.2,"high":23.9}],"markers":[{"label":"Ask","value":25}]}]}'

When it refuses

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

Code	When	What to do
`invalid_input`400	A slide lacks what its type needs, or its rows, values or ranges don't fit together.	The message names the slide and what to change.
`unsupported_type`400	The template isn't a .pptx or .potx, or an image or logo isn't a PNG or JPEG.	Upload the right kind of file.
`not_found`404	No file with that id on this account.	files_list shows them.
`deck_error`422	The template doesn't open, or a slide could not be drawn.	Use another template, or change the slide the message names.
`deck_too_slow`422	Making the deck took over a minute.	Send fewer slides at a time.

Give this to your agent.

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

Make a PowerPoint deck

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Documents tools

Give this to your agent.