Sign in

v1

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

Create team

Create a new team.

gigstack Connect: Create teams using the team parameter.

post/teams

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

metadataobject nullable

Additional metadata to store with the team

support_emailstring email nullable
support_phonestring nullable
tax_idstring nullable
tax_systemstring nullable
generate_onboarding_urlboolean nullable

Generate onboarding URL for team setup

legal_namestring nullable

Legal name of the team/company

add_master_team_membersboolean nullable

When true, copies all members from the master team to the newly created team with their existing permissions

credit_limitnumber nullable

Maximum number of documents (credits) the team can create per billing period. When null or omitted, the team shares the billing account pool with no per-team cap.

Example request

{
  "address": {
    "country": "MEX",
    "street": "Av. Insurgentes Sur",
    "zip": "03100",
    "city": "Ciudad de México",
    "state": "CDMX",
    "exterior": "123",
    "interior": "4B",
    "municipality": "Benito Juárez",
    "neighborhood": "Del Valle"
  },
  "brand": {
    "alias": "My Company",
    "primary_color": "#FF0000",
    "secondary_color": "#00FF00",
    "logo": "https://example.com/logo.png"
  },
  "support_email": "support@company.com",
  "support_phone": "+52 55 1234 5678",
  "tax_id": "ABC123456789",
  "tax_system": "601",
  "generate_onboarding_url": true,
  "add_members": [
    {
      "id": "user123abc",
      "role": "editor"
    },
    {
      "id": "user456def",
      "role": "admin"
    }
  ],
  "legal_name": "Empresa de Tecnología S.A. de C.V.",
  "credit_limit": 1000
}

Response

Team created successfully

messagestring

Example response

{
  "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",
      "emails": {
        "invoices_bcc": [
          "accounting@example.com"
        ],
        "avoid_test_invoice_emails": true
      },
      "override_item_description": "Custom item description",
      "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,
      "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": {
        "category": "payments"
      },
      "mercadopago": {
        "category": "payments"
      },
      "clip": {
        "category": "payments"
      },
      "whmcs": {
        "category": "payments"
      },
      "paypal": {
        "category": "payments"
      },
      "openpay": {
        "category": "payments"
      },
      "conekta": {
        "category": "payments"
      },
      "bank": {
        "category": "payments"
      },
      "shopify": {
        "category": "payments"
      },
      "zapier": {
        "category": "payments"
      },
      "airtable": {
        "category": "payments"
      },
      "google_sheets": {
        "category": "payments"
      },
      "hilos": {
        "category": "messaging"
      }
    },
    "credit_limit": 1000,
    "used_credits": 250,
    "credit_period_start": 1677651234000,
    "metadata": {
      "custom_field": "value"
    },
    "onboarding_url": "https://embeded.gigstack.pro/?sessionId=otpOnboarding_abc123&c=secure_token"
  }
}