---
title: "Upload SAT CSD certificates"
method: POST
path: "/teams/{id}/sat-connection"
tags: ["Teams"]
---

# Upload SAT CSD certificates

`POST /teams/{id}/sat-connection`

Upload SAT CSD (Certificado de Sello Digital) certificates to establish SAT connection for CFDI invoicing.

This endpoint accepts multipart form data with the certificate files and password.

## Required Files
- **cert**: Certificate file (.cer) - The public certificate
- **key**: Private key file (.key) - The encrypted private key
- **keyPass**: Password for the private key

## First-Time Connection
When this is the first SAT connection for a team (no previous SAT setup),
the system will automatically initialize default invoice series (G, NC, P, T).

**gigstack Connect:** Upload SAT certificates for other teams using the `team` parameter.

## Path parameters

- `id` string, required

## Query parameters

- `team` string

## Response `200`

SAT connection established successfully

- object
  - `message` string, required
  - `data` object, required
    - `isValid` boolean
    - `details` object
      - `serialNumber` string
      - `validTo` number

## Other responses

- `400` — Bad Request - Missing files or invalid certificate
- `401` — Unauthorized
- `403` — Forbidden - Team not in same billing account
- `404` — Team not found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/disruptive-learning/apis/gigstack-api-v2.md) · [All operations](https://skmtc.dev/disruptive-learning/apis/gigstack-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/disruptive-learning/gigstack-api-v2/revisions/5cf53ffd7580/schema)