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 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-dataRequired

Responses

🟢200OK

application/json

SAT connection established successfully

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

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

Modified at 2026-08-14 03:51:35

Delete team

Sign manifest document

Upload SAT CSD certificates

Required Files#

First-Time Connection#

Request

Responses

Required Files

First-Time Connection