# rendercarbonecloudtemplate: Render Carbone Cloud Template

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

Renders a carbone clooud template by a given ID with specified data. Requires a Carbone Cloud API key.

- This service is provided by an external service provider: Carbone.io. The data of the call is sent to the provider. [More about service providers](https://1001fx.com/functions#serviceproviders)

- Group: Carbone documents
- Endpoint: `POST https://api.1001fx.com/carbone/rendercarbonecloudtemplate`
- Authentication: header `X-API-KEY: YOURSECRETAPIKEY`
- Content type: application/json
- Credits: 3 credits per call
- Ready-made in: n8n
- Service provider: Carbone.io
- Docs: https://1001fx.com/functions/rendercarbonecloudtemplate

## Parameters

- `apiKey` (string, required) – API Key: Your carbone.io API Key.
- `templateId` (string, required) – Template ID: Your carbone.io template ID.
- `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`, default `pdf`) – Output Format: Output format for your rendered template. Defaults to pdf.

## Example: Get Carbone Template

```bash
curl -X POST 'https://api.1001fx.com/carbone/rendercarbonecloudtemplate' \
  -H 'X-API-KEY: YOURSECRETAPIKEY' \
  -H 'Content-Type: application/json' \
  -d '{"apiKey":"yourApiKey","templateId":"590c9afdfaafceca2133937b4939aaa554d828c4de0e6fc1e00427813238dbcf","data":{"companyName":"JohnInsurance & Co","period":2,"sD":1659041229,"id":2891,"insured":{"name":"Jean Michel","street":"23, Sycamore Street","city":"New York","phone":"+33 2 38 99 18 23"},"showPropertyDamage":false,"propertyDamage":[{"type":"Fire"},{"type":"Wind"},{"type":"Hail"},{"type":"Water"}],"options":[{"type":"Furniture","note":"/","cost":1200},{"type":"Appliances","note":"/","cost":400},{"type":"Clothing","note":"/","cost":300},{"type":"Dishes","note":"in some cases","cost":300}],"optionsTotalHT":2200,"optionsTaxes":10,"optionsTotal":2420}}'
```