Update Connections

Summary

This guide explains how to update existing connections in Zoho Sigma. It covers modifying connection details, refreshing credentials, and ensuring your extension uses the updated connection information.

When to Update Connections

  • Credentials expire or need renewal
  • Service credentials are compromised
  • API keys need rotation
  • Permission scopes need to be modified
  • Service configuration changes
  • Account migration

Step-by-Step Guide

Step 1: Access Connections in Sigma

  1. Navigate to Zoho Sigma
  2. Click Connections in the left navigation
  3. Find your connection under "My Connections"

Step 2: Open Connection for Editing

  • Option A: Hover over the connection and click the Edit icon that appears
  • Option B: Click the connection name → Click More Icon (three dots) → Select Edit

Step 3: Make Changes

FieldCan Update?Notes
Connection NameYesDisplay name only
Connection Link NameNoRead-only after creation
ScopesYesAdd or remove permissions
CredentialsYesRe-authenticate to update
Service-specific settingsYesDepends on service

Step 4: Update Credentials (If Needed)

  • For OAuth: Click "Reconnect" → Follow service login flow → Grant updated permissions
  • For Basic Auth: Update username/password → Verify credentials
  • For API Key: Update API key value → Ensure service recognizes the new key

Step 5: Save Changes

Click Update. Zoho validates the changes and saves the updated configuration. Re-authenticate if prompted.

Update plugin-manifest.json

Note: The Connection Link Name cannot change, so the plugin-manifest reference remains valid. However, if scopes or service details change significantly, get the updated connection JSON from Sigma and replace the entry in connectors.
{
  "connectors": [
    // Replace OLD connection JSON with the new one copied from Sigma
    {
      "name": "salesforce_connection",
      "type": "OAuth",
      "authorizationUrl": "https://...",
      "scopes": ["api", "refresh_token", "contacts"]  // Updated scopes
    }
  ]
}

Troubleshooting

Problem: Connection still fails after update

Solution: Verify the connection shows as "Active" in Sigma. Test with a simple API call in your extension and check the browser console for error details.

Problem: Scopes change not taking effect

Solution: After updating scopes, re-authenticate the connection (click "Reconnect") so the new scope permissions are granted by the service.

Related Pages