Create team

POST

https://api.gigstack.io/v2/teams

Create a new team.

gigstack Connect: Create teams using the team parameter.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

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

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Team created successfully

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.gigstack.io/v2/teams?team' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "address": {
        "country": "Mexico",
        "street": "Av. Reforma",
        "zip": "11000",
        "city": "Ciudad de México",
        "state": "CDMX",
        "exterior": "456",
        "municipality": "Miguel Hidalgo",
        "neighborhood": "Polanco"
    },
    "brand": {
        "alias": "Empresa Innovadora",
        "primary_color": "#2563eb",
        "secondary_color": "#1d4ed8",
        "logo": "https://example.com/logo.png"
    },
    "support_email": "soporte@empresa.com",
    "support_phone": "+52 55 9876 5432",
    "tax_id": "EIN850123ABC",
    "tax_system": "601",
    "generate_onboarding_url": true,
    "add_members": [
        {
            "id": "user123abc",
            "role": "editor"
        },
        {
            "id": "user456def",
            "role": "viewer"
        }
    ],
    "add_master_team_members": false
}'

Response Example

{
    "message": "Team created successfully",
    "data": {
        "id": "team_1234567890",
        "legal_name": "Empresa de Tecnología S.A. de C.V.",
        "address": {
            "country": "MEX",
            "street": "Av. Insurgentes Sur 456",
            "zip": "03100",
            "city": "Ciudad de México",
            "state": "CDMX",
            "exterior": "96",
            "interior": "10",
            "neighborhood": "Polanco"
        },
        "brand": {
            "alias": "Mi Empresa",
            "primary_color": "#007bff",
            "secondary_color": "#6c757d",
            "logo": "https://example.com/logo.png"
        },
        "settings": {
            "avoid_automations_on_currencies": [
                "USD",
                "EUR"
            ],
            "default_description": "Default invoice description",
            "taxes": [
                {}
            ],
            "taxes_usd": [
                {}
            ],
            "emails": {
                "invoices_bcc": [
                    "accounting@example.com"
                ],
                "avoid_invoice_emails": false,
                "avoid_test_invoice_emails": true,
                "avoid_receipts_emails": false
            },
            "override_item_description": "Custom item description",
            "global_invoice_disabled": false,
            "complements": [
                {
                    "data": "string",
                    "description": "string",
                    "type": "string"
                }
            ],
            "uses_on_self_invoice_portal": [
                "G03",
                "S01"
            ],
            "invoice_pdf_notes": "Additional notes for PDF",
            "product_key": "81112209",
            "unit_key": "E48",
            "use": "G03",
            "automate_complement_for_ppd_invoices": true,
            "withholding_taxes": [
                {}
            ],
            "customer_portal_id": "portal_1234567890",
            "periodicity": {
                "label": "Mes",
                "value": "month"
            },
            "default_series": {
                "income": {
                    "serie": "A"
                },
                "complements": {
                    "serie": "P"
                },
                "credit_note": {
                    "serie": "NC"
                }
            }
        },
        "tax_id": "EMP800101ABC",
        "tax_system": "601",
        "support_email": "support@empresa.com",
        "support_phone": "+52 55 1234 5678",
        "owner": "user_1234567890",
        "created_at": 1677651234,
        "sat": {
            "completed": true,
            "connected_at": 1677651234,
            "csd_expires_at": 1924991999
        },
        "members": [
            {
                "id": "user_1234567890",
                "email": "member@empresa.com",
                "role": "admin"
            }
        ],
        "integrations": {
            "stripe": {
                "completed": false,
                "category": "payments"
            },
            "mercadopago": {
                "completed": false,
                "category": "payments"
            },
            "clip": {
                "completed": false,
                "category": "payments"
            },
            "whmcs": {
                "completed": false,
                "category": "payments"
            },
            "paypal": {
                "completed": false,
                "category": "payments"
            },
            "openpay": {
                "completed": false,
                "category": "payments"
            },
            "conekta": {
                "completed": false,
                "category": "payments"
            },
            "bank": {
                "completed": false,
                "category": "payments"
            },
            "shopify": {
                "completed": false,
                "category": "payments"
            },
            "zapier": {
                "completed": false,
                "category": "payments"
            },
            "airtable": {
                "completed": false,
                "category": "payments"
            },
            "google_sheets": {
                "completed": false,
                "category": "payments"
            },
            "hilos": {
                "completed": false,
                "category": "messaging"
            }
        },
        "metadata": {
            "custom_field": "value"
        },
        "onboarding_url": "https://embeded.gigstack.pro/?sessionId=otpOnboarding_abc123&c=secure_token"
    }
}

Modified at 2026-01-23 18:33:49

Update team settings

Add team member