> ## Documentation Index > Fetch the complete documentation index at: https://docs.maadify.com/llms.txt > Use this file to discover all available pages before exploring further. # Connectors > Connect applications, configure tools, and validate access ## What connectors do Connectors store application authentication and expose tools to your tenant. Tools can be used in agents or shared to connected companies. You can also lock default tool configuration values for tighter security. Connectors grid showing search, add connector, and connector cards ## Connect an application Go to **Connectors** and select **Add connector**. Search for the connector and select it from the list. Complete the required fields. Some fields are masked and the data will be encrypted at rest. Required fields show validation errors until they are complete. Save the connector and verify the connection status. A healthy connection shows a success status and connected account name. Connector form with API key authentication fields Sign in with Google OAuth prompt for the connector Gmail connector card showing a successful Google connection ## Customize the connector You can update the custom name and description for a connector. This label appears in connector cards and tool lists. Connector custom name and description editor ## Configure tool defaults Tool defaults lock specific fields so agents cannot override them. Use this to constrain what a tool can do. Open a connector and select **Edit tools**. Choose a tool that is already configured for the connector. Add fixed values for required fields, like environment or account IDs. The tool is now available with the locked defaults. Tool configuration panel with default values set ## Manage tools for a connector Use **Edit tools** to manage which tools are available to your tenant. * **Configured tools** are already available for agents. * **Available tools** can be added to the connector. * **Orphaned tools** are configured but no longer attached to a connector. Review how many tenants and agents use a tool before removing it. ## Share tools to connected companies Share a tool with a connected company so their agents can use it without you handing over the connector itself. You control how much access each company has, and your tool defaults still apply. Open a connector, select **Edit tools**, choose a configured tool, and switch to the **Shared Tenants** tab. Select **Add Shared Tenant** and pick a tenant relationship. Only relationships that already exist between your tenant and the other company appear in the list. Select **view**, **use**, or **full**, then confirm. Share tool to tenant panel ### Access levels Each share has one access level per shared tenant. As the connector owner, you can change the level at any time from the **Shared Tenants** tab. The shared tenant can see the tool in their tool list but cannot assign it to agents or execute it. Use **view** when you want a company to know the tool exists without granting runtime access. The shared tenant can assign the tool to parent agents and sub-agents and run it through agent workflows. Input parameters are locked to your tool defaults — the shared tenant cannot override field values, even if their own configuration would set them differently. Use **use** when you want strict, default-driven execution. The shared tenant can assign the tool to agents and freely edit input parameters at runtime, including making any query the tool's schema allows. Use **full** when you trust the tenant to drive the tool with their own inputs. Combine **use** access with locked tool defaults for safe sharing. The shared tenant gets the productivity of the tool without being able to change sensitive fields. ### Update or remove a share From the **Shared Tenants** tab you can: * **Edit Shared Tenant** to change the access level for an existing share. * **Delete Shared Tenant** to remove the share entirely. If parent agents or sub-agents in the shared tenant are using the tool, they are listed in the confirmation so you can review the impact first. Removing a share immediately revokes access and removes the tool from every parent agent and sub-agent that uses it in the shared tenant. ## Test tools Use the **Test tools** view to validate authentication and verify responses. This view appears in the **Connectors** page for users with tool execution access. Successful tool tests show inputs, outputs, runtime details, and any errors. Tool test panel showing inputs and outputs Use the async execution toggle when a tool may take longer to return a response. ## Delete a connector When you delete a connector, you can choose to also delete related tools. Deleting related tools removes them from the system and can affect existing agent configurations and triggers. Deleting a connector can impact active workflows and triggers. ## Troubleshooting * Verify the credentials are valid and not expired. * Re-authenticate the connector and save. * Open the connector and check the connected account name. * Update the connection to refresh credentials. * Confirm the tool is enabled in the connector. * Check if the tool is restricted for your tenant. * Review required fields in the tool configuration. * Validate that the connected account has permission for the action.