Sign in

v1

latestOpenAPI 3.0.3Proprietaryraw.githubusercontent.com2026-03-067260437.0 KB
Teams

Update team 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
put/teams/{id}/settings

Path parameters

idstring required

Team ID

Query parameters

teamstring

gigstack Connect: Target team ID for multi-team access.

Requires gigstack Connect enabled on your team and shared billing account.

Example: ?team=team_xyz789

Request body

keep_full_legal_nameboolean nullable

Keep full legal name in documents

default_descriptionstring nullable

Default description for items

taxesobject[] nullable

Default taxes configuration for MXN

taxes_usdobject[] nullable

Default taxes configuration for USD

override_item_descriptionstring nullable

Override description for all items

global_invoice_disabledboolean nullable

Disable global invoice functionality

complementsobject[] nullable

CFDI complements configuration

uses_on_self_invoice_portalstring[] nullable

Available CFDI uses on self-invoice portal

invoice_pdf_notesstring nullable

Default notes to include in invoice PDFs

product_keystring nullable

Default SAT product key

unit_keystring nullable

Default SAT unit key

usestring nullable

Default CFDI use

automate_complement_for_ppd_invoicesboolean nullable

Automatically create payment complement for PPD invoices

withholding_taxesobject[] nullable

Withholding taxes configuration

periodicity'day' | 'week' | 'two_weeks' | 'month' | 'two_months' nullable

Default billing/invoicing period for the team

Example request

{
  "default_description": "Consulting services",
  "emails": {
    "invoices_bcc": [
      "admin@company.com"
    ],
    "avoid_test_invoice_emails": true
  },
  "override_item_description": "Professional services",
  "uses_on_self_invoice_portal": [
    "P01",
    "P02"
  ],
  "invoice_pdf_notes": "Additional notes for PDF invoices",
  "product_key": "80141503",
  "unit_key": "E48",
  "use": "P01",
  "periodicity": "month",
  "default_series": {
    "income": {
      "serie": "A",
      "folio_number_live": 1001,
      "folio_number_test": 1
    },
    "complements": {
      "serie": "C",
      "folio_number_live": 1001,
      "folio_number_test": 1
    },
    "credit_note": {
      "serie": "N",
      "folio_number_live": 1001,
      "folio_number_test": 1
    }
  }
}

Response

Team settings updated successfully

messagestring required
dataobject required

Example response

{
  "message": "Team settings updated"
}