---
title: "Update team settings"
method: PUT
path: "/teams/{id}/settings"
tags: ["Teams"]
---

# Update team settings

`PUT /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

## Path parameters

- `id` string, required

## Query parameters

- `team` string

## Request body

- TeamSettingsInput
  - `keep_full_legal_name` boolean, nullable — Keep full legal name in documents
  - `default_description` string, nullable — Default description for items
  - `taxes` object[], nullable — Default taxes configuration for MXN
  - `taxes_usd` object[], nullable — Default taxes configuration for USD
  - `emails` object, nullable
    - `invoices_bcc` string[], nullable — BCC emails for invoices
    - `avoid_invoice_emails` boolean, nullable — Disable invoice emails
    - `avoid_test_invoice_emails` boolean, nullable — Disable test invoice emails
    - `avoid_receipts_emails` boolean, nullable — Disable receipt emails
  - `override_item_description` string, nullable — Override description for all items
  - `global_invoice_disabled` boolean, nullable — Disable global invoice functionality
  - `complements` object[], nullable — CFDI complements configuration
  - `uses_on_self_invoice_portal` string[], nullable — Available CFDI uses on self-invoice portal
  - `invoice_pdf_notes` string, nullable — Default notes to include in invoice PDFs
  - `product_key` string, nullable — Default SAT product key
  - `unit_key` string, nullable — Default SAT unit key
  - `use` string, nullable — Default CFDI use
  - `automate_complement_for_ppd_invoices` boolean, nullable — Automatically create payment complement for PPD invoices
  - `withholding_taxes` object[], nullable — Withholding taxes configuration
  - `periodicity` 'day' | 'week' | 'two_weeks' | 'month' | 'two_months', nullable — Default billing/invoicing period for the team
  - `default_series` object, nullable
    - `income` object, nullable
      - `serie` string, nullable — Default income series
      - `folio_number_live` number, nullable — Next folio number for live environment
      - `folio_number_test` number, nullable — Next folio number for test environment
    - `complements` object, nullable
      - `serie` string, nullable — Default complements series
      - `folio_number_live` number, nullable — Next folio number for live environment
      - `folio_number_test` number, nullable — Next folio number for test environment
    - `credit_note` object, nullable
      - `serie` string, nullable — Default credit note series
      - `folio_number_live` number, nullable — Next folio number for live environment
      - `folio_number_test` number, nullable — Next folio number for test environment

## Response `200`

Team settings updated successfully

- object
  - `message` string, required
  - `data` object, required

## Other responses

- `400` — Bad Request - Invalid settings data
- `401` — Unauthorized
- `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)