Update team settings

PUT

https://api.gigstack.io/v2/teams/{id}/settings

Update team settings including defaults for invoicing, taxes, series, and email configurations.

gigstack Connect: Update settings for other teams using the team parameter.

Team Settings Configuration

This endpoint allows you to configure various team-wide defaults and behaviors:

Invoice Settings: Default descriptions, PDF notes, product keys

Tax Configuration: Default taxes for MXN and USD currencies

Email Settings: BCC recipients, email preferences

CFDI Configuration: Default series, uses, product/unit keys

Automation: Payment complement automation for PPD invoices

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

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

Path Params

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200Correcto

application/json

Team settings updated successfully

Body

🟠400Solicitud incorrecta

🟠401No autenticado

🟠404No encontrado

🔴500Error interno del servidor

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.gigstack.io/v2/teams/team_1234567890/settings?team' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "keep_full_legal_name": false,
    "default_description": "Professional consulting services",
    "invoice_pdf_notes": "Thank you for your business",
    "product_key": "80141503",
    "unit_key": "E48",
    "use": "P01",
    "emails": {
        "invoices_bcc": [
            "admin@company.com"
        ],
        "avoid_invoice_emails": false
    },
    "default_series": {
        "income": {
            "serie": "A",
            "folio_number_live": 1001,
            "folio_number_test": 1
        }
    }
}'

Response Example

200 - Example 1

{
    "message": "Team settings updated",
    "data": {}
}

Modified at 2025-10-09 23:51:05

Update team series

Create team

Update team settings

Team Settings Configuration#

Request

Responses

Team Settings Configuration