curl --request POST \
--url https://api.gigstack.io/v2/teams/{id}/integration-connection-sessions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"provider": "airtable",
"expected_livemode": true,
"recovery_operation_id": "<string>",
"acknowledge_unconfirmed_effects": true
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
provider: 'airtable',
expected_livemode: true,
recovery_operation_id: '<string>',
acknowledge_unconfirmed_effects: true
})
};
fetch('https://api.gigstack.io/v2/teams/{id}/integration-connection-sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.gigstack.io/v2/teams/{id}/integration-connection-sessions"
payload = {
"provider": "airtable",
"expected_livemode": True,
"recovery_operation_id": "<string>",
"acknowledge_unconfirmed_effects": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"success": true,
"data": {
"id": "<string>",
"team_id": "<string>",
"team": {
"id": "<string>",
"name": "<string>"
},
"provider": "airtable",
"method": "oauth",
"credential_livemode": true,
"effect_scope": "team_shared_credentials",
"status": "pending",
"created_at": 123,
"expires_at": 123,
"updated_at": 123,
"completion_url": "<string>",
"can_submit": true,
"recovery_available_at": 123,
"disclosures": [
"<string>"
],
"credential_schema": {},
"result": {
"connected": true,
"credentials_may_be_stored": true
},
"error": {
"code": "<string>",
"message": "<string>"
},
"resolution": {
"action": "released_for_new_session",
"resolved_at": 123
},
"recovery": {
"operation_id": "<string>",
"action": "register",
"original_status": "outcome_unknown",
"effect_scope": "shared_connection",
"livemode": true,
"local_disabled_count": 1,
"snapshot_complete": true,
"identity_verification": "pending",
"imports_disabled": true,
"prior_outcome_preserved": true
}
},
"timestamp": 123
}Create provider browser setup session
Requires a verified personal Firebase/MCP credential and current provider configuration authority. Team API/OAuth keys cannot impersonate their creator. Test import mode does not isolate real provider accounts; read effect_scope and disclosures. Creates a ten-minute session and completion_url for the signed-in person. Read disclosures and credential_schema in the browser before consent. One pending/in-flight/unknown session per team/provider. Initial providers only: Airtable, MercadoLibre, NetSuite and Zettle.
curl --request POST \
--url https://api.gigstack.io/v2/teams/{id}/integration-connection-sessions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"provider": "airtable",
"expected_livemode": true,
"recovery_operation_id": "<string>",
"acknowledge_unconfirmed_effects": true
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
provider: 'airtable',
expected_livemode: true,
recovery_operation_id: '<string>',
acknowledge_unconfirmed_effects: true
})
};
fetch('https://api.gigstack.io/v2/teams/{id}/integration-connection-sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.gigstack.io/v2/teams/{id}/integration-connection-sessions"
payload = {
"provider": "airtable",
"expected_livemode": True,
"recovery_operation_id": "<string>",
"acknowledge_unconfirmed_effects": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"success": true,
"data": {
"id": "<string>",
"team_id": "<string>",
"team": {
"id": "<string>",
"name": "<string>"
},
"provider": "airtable",
"method": "oauth",
"credential_livemode": true,
"effect_scope": "team_shared_credentials",
"status": "pending",
"created_at": 123,
"expires_at": 123,
"updated_at": 123,
"completion_url": "<string>",
"can_submit": true,
"recovery_available_at": 123,
"disclosures": [
"<string>"
],
"credential_schema": {},
"result": {
"connected": true,
"credentials_may_be_stored": true
},
"error": {
"code": "<string>",
"message": "<string>"
},
"resolution": {
"action": "released_for_new_session",
"resolved_at": 123
},
"recovery": {
"operation_id": "<string>",
"action": "register",
"original_status": "outcome_unknown",
"effect_scope": "shared_connection",
"livemode": true,
"local_disabled_count": 1,
"snapshot_complete": true,
"identity_verification": "pending",
"imports_disabled": true,
"prior_outcome_preserved": true
}
},
"timestamp": 123
}Authorizations
Authentication Method: HTTP Bearer token.
The runtime requires the literal Bearer prefix — a bare token in the
Authorization header is rejected with 401 unauthorized.
Header Format: Authorization: Bearer YOUR_API_KEY
Your API key is a JWT. Live keys operate on live data (livemode: true);
test keys operate on isolated test data (livemode: false).
Get your key at: app.gigstack.pro/settings?tab=api
Errors: credential failures are answered by the authentication layer with a raw
{ "message": … } body, not the standardized envelope — 401 for a missing, malformed or
expired token, 403 for a revoked key or a plan without API access. See the Unauthorized
and AuthForbidden responses.
Path Parameters
Body
- Option 1
- Option 2
- Option 3
airtable 36^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$true