# rendercarbonetemplate: Render Carbone Template

> rendercarbonetemplate (Render Carbone Template) is a 1001fx API function in the group Carbone documents: POST https://api.1001fx.com/carbone/rendercarbonetemplate, 5 credits per call. It works as a ready-made module in Make and n8n or as a plain HTTP call.

Fills the provided carbone template with data. This function uses the Carbone JS Community Edition on 1001fx servers.

- Group: Carbone documents
- Endpoint: `POST https://api.1001fx.com/carbone/rendercarbonetemplate`
- Authentication: header `X-API-KEY: YOURSECRETAPIKEY`
- Content type: multipart/form-data
- Credits: 5 credits per call
- Ready-made in: Make and n8n
- Docs: https://1001fx.com/functions/rendercarbonetemplate

## Parameters

- `file` (file, required) – Template file: Template file to be processed.
- `data` (object, optional) – Data: Data to fill your template with. Either data or stringified data needs to be provided.
- `stringifiedData` (string, optional) – Stringified Data: Stringified data to fill your template with.
- `outputFormat` (enum, optional, one of `pdf`, `xslx`, `docx`, `ods`, `csv`, `txt`, `odt`) – Output Format: Output format for your rendered template. Defaults to the format of the provided template.

## Use cases

- Fill a Word contract template with customer data and save it as PDF
- Create Excel reports from a template and workflow data
- Generate letters or certificates in bulk from one ODT template

## Example: Render a TXT template

```bash
curl -X POST 'https://api.1001fx.com/carbone/rendercarbonetemplate' \
  -H 'X-API-KEY: YOURSECRETAPIKEY' \
  -F 'file=@carbonetemplate.txt'
```

## FAQ

**Which template formats can I use?**

Carbone templates such as DOCX, XLSX, ODT, TXT, HTML and XML. The output can be converted with outputFormat, for example to PDF; without it the format of the template is kept.

**How do I pass the data?**

As JSON object in data or as a JSON string in stringifiedData. One of the two is required.

**Is the template sent to Carbone Cloud?**

No. This function uses the Carbone JS Community Edition on the 1001fx servers. For templates stored in Carbone Cloud use rendercarbonecloudtemplate.
