gigstack API

Create a team

Develop Env

https://api.gigstack.io/v2

POST

/connect/teams

Connect

Creates a new team with specified members and configuration

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.gigstack.io/v2/connect/teams' \
--header 'Content-Type: application/json' \
--header 'Authorization;' \
--data-raw '{
    "members": [
        "string"
    ],
    "alias": "string",
    "primaryColor": "string",
    "logoUrl": "http://example.com",
    "legalName": "string",
    "taxId": "string",
    "address": {
        "street": "string",
        "city": "string",
        "state": "string",
        "zip": "string",
        "country": "string"
    },
    "contactEmails": [
        "user@example.com"
    ],
    "supportEmail": "user@example.com",
    "supportPhone": "string",
    "taxSystem": "string",
    "metadata": {}
}'

Response Example

200 - Example 1

{
    "data": {
        "id": "string",
        "alias": "string",
        "legalName": "string",
        "logo": "string",
        "primaryColor": "string",
        "setupComplete": true,
        "members": [
            {
                "id": "string",
                "email": "user@example.com",
                "role": "string",
                "isAdmin": true,
                "isSuperAdmin": true,
                "status": "string",
                "permissions": {
                    "invoices": "string",
                    "payments": "string",
                    "expenses": "string",
                    "services": "string"
                }
            }
        ],
        "supportEmail": "user@example.com",
        "address": {
            "street": "string",
            "city": "string",
            "state": "string",
            "zip": "string",
            "country": "string"
        },
        "integrations": {
            "stripe": {
                "completed": true,
                "hasKeys": true
            },
            "facturapi": {
                "completed": true,
                "hasKeys": true
            },
            "sat": {
                "completed": true,
                "provider": "string",
                "hasCertificate": true
            }
        },
        "invoicesCreated": 0,
        "paymentsCreated": 0,
        "receiptsCreated": 0,
        "onboardingUrl": "http://example.com"
    },
    "message": "string",
    "next": "string",
    "totalResults": 0,
    "hasMore": true
}

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

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

Body Params application/json

members

array[string]

required

Array of user IDs to add as team members

alias

string

required

Team display name

primaryColor

string

required

Primary brand color (hex format)

logoUrl

string <uri>

required

URL to team logo

legalName

string

required

Legal business name

taxId

string

optional

Tax identification number

address

object (Address)

required

street

string

optional

city

string

optional

state

string

optional

zip

string

optional

country

string

optional

contactEmails

array[string <email>]

required

supportEmail

string <email>

required

supportPhone

string

optional

taxSystem

string

optional

metadata

object

optional

Examples

Responses

🟢200OK

application/json

Team created successfully

Body

data

object

optional

string

optional

Unique team identifier

alias

string

optional

Team display name

legalName

string

optional

Legal business name

logo

string

optional

Team logo URL

primaryColor

string

optional

Primary brand color

setupComplete

boolean

optional

Whether team setup is complete

members

array[object (TeamMember) {7}]

optional

supportEmail

string <email>

optional

address

object

Address

optional

integrations

object

TeamIntegrations

optional

invoicesCreated

integer

optional

paymentsCreated

integer

optional

receiptsCreated

integer

optional

onboardingUrl

string <uri>

optional

message

string

optional

string | null

optional

totalResults

integer

optional

hasMore

boolean

optional

🟠400Bad Request

🟠401Unauthorized

Modified at 2025-06-16 03:36:47

Connect

List teams