Upload SAT CSD certificates

POST

https://api.gigstack.io/v2/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 or Facturapi 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.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

Query Params

Body Params multipart/form-data

Responses

🟢200OK

application/json

SAT connection established successfully

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.gigstack.io/v2/teams//sat-connection' \
--header 'Authorization: <api-key>' \
--form 'cert=@""' \
--form 'key=@""' \
--form 'keyPass=""'

Response Example

200 - Example 1

{
    "message": "SAT connection established successfully",
    "data": {
        "isValid": true,
        "details": {
            "serialNumber": "30001000000500003416",
            "validTo": 1735689600000
        }
    }
}

Modified at 2025-12-01 22:41:05

Create team series

Users API Guide

Upload SAT CSD certificates

Required Files#

First-Time Connection#

Request

Responses

Required Files

First-Time Connection