---
title: "Upload a certificate for a connection"
method: POST
path: "/fiscal-document/v1/fiscalization/connections/{connectionId}/certificate"
tags: ["Fiscal Connection Config"]
---

# Upload a certificate for a connection

`POST /fiscal-document/v1/fiscalization/connections/{connectionId}/certificate`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/fiscal-document/v1/fiscalization/connections/{connectionId}/certificate`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://api.cloudbeds.com/auth/oauth/authorize`
    - Token URL: `https://api.cloudbeds.com/auth/oauth/token` scopes: `write:reservation`

Uploads a certificate file for the given connection's fiscalization provider.
Resolves the provider and country from the connectionId. Mirrors the deprecated
singular endpoint contract but is scoped by connectionId.

## Path parameters

- `connectionId` integer, required

## Headers

- `X-Property-ID` integer, required

## Request body `multipart/form-data`

- object
  - `file` string, binary, required: Certificate or ownership document file
  - `privateKey` string, binary: Private key file (required for MX e.firma)
  - `password` string: Certificate or private key password (if required)

## Response `204`

Certificate uploaded and submitted for verification

## Other responses

- `400`: Bad Request
- `422`: Invalid certificate (rejected by provider)

---

[API](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api.md) - [All operations](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api/revisions/9c2a47775e5e?raw)