curl --request PATCH \
--url https://api.gigstack.io/v2/teams/{id}/integrations/{provider}/settings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"automatic_invoicing": false
}
'{
"success": true,
"data": {
"provider": "stripe",
"label": "<string>",
"category": "payments",
"mode_scope": "team_shared",
"source": "stored_configuration",
"completed": true,
"region_available": true,
"regions": [
"<string>"
],
"installation": {
"allowed": true,
"reason": "<string>",
"limit": 123,
"used": 123
},
"settings": {
"automatic_invoicing": true,
"test_only": true,
"automatic_refunds": true,
"ppd_flow": true,
"use_provider_exchange_rate": true,
"convert_payments_to_currency": "<string>",
"default_payment_method": "<string>",
"customer_balance_payment_method": "<string>",
"stripe_payment_method": "<string>",
"service_description": "<string>",
"payment_form": "<string>",
"default_payment_form": "<string>",
"bic": "<string>",
"clabe": "<string>",
"country": "<string>",
"holder_name": "<string>",
"iban": "<string>",
"help": "<string>",
"swift": "<string>",
"voucher_required": true,
"account_number": "<string>",
"routing_number": "<string>"
},
"connected_at": 123,
"last_sync_at": 123,
"web_actions": [
"<string>"
],
"api_actions": [
"<string>"
],
"team_id": "<string>"
},
"timestamp": 123
}Update provider settings
Reads current stored configuration; completed does not establish current provider health. The catalog distinguishes dashboard actions from implemented API actions. Region and installation eligibility mirror existing web rules. Settings affect the team across credential data modes. Current authorized members can read; mutations recheck current team/owning-account administrator authority for user credentials. API keys retain their current team scope.
Only fields for the selected provider are accepted. Existing non-bank connection required. Bank instructions require country and holder name, plus a valid CLABE for MEX; saving marks them configured without verifying bank ownership. Existing installation limit applies to first bank configuration. No credentials or worker state are replaced.
curl --request PATCH \
--url https://api.gigstack.io/v2/teams/{id}/integrations/{provider}/settings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"automatic_invoicing": false
}
'{
"success": true,
"data": {
"provider": "stripe",
"label": "<string>",
"category": "payments",
"mode_scope": "team_shared",
"source": "stored_configuration",
"completed": true,
"region_available": true,
"regions": [
"<string>"
],
"installation": {
"allowed": true,
"reason": "<string>",
"limit": 123,
"used": 123
},
"settings": {
"automatic_invoicing": true,
"test_only": true,
"automatic_refunds": true,
"ppd_flow": true,
"use_provider_exchange_rate": true,
"convert_payments_to_currency": "<string>",
"default_payment_method": "<string>",
"customer_balance_payment_method": "<string>",
"stripe_payment_method": "<string>",
"service_description": "<string>",
"payment_form": "<string>",
"default_payment_form": "<string>",
"bic": "<string>",
"clabe": "<string>",
"country": "<string>",
"holder_name": "<string>",
"iban": "<string>",
"help": "<string>",
"swift": "<string>",
"voucher_required": true,
"account_number": "<string>",
"routing_number": "<string>"
},
"connected_at": 123,
"last_sync_at": 123,
"web_actions": [
"<string>"
],
"api_actions": [
"<string>"
],
"team_id": "<string>"
},
"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
stripe, adyen, paypal, zettle, conekta, openpay, clip, clockpms, pagoralia, dlocal, woocommerce, mercadopago, mercadolibre, airtable, shopify, bank, sheets, netsuite, whatsapp, zapier, whmcs, hilos, sat, sat_download, factus Body
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
- Option 12
- Option 13
Settings accepted only for provider=stripe. Fields omitted from the request remain unchanged. Read the provider state after a write. Nullable text clears; boolean null is rejected.
^[A-Z]{3}$2^\d{2}$2^\d{2}$2^\d{2}$