Skip to main content

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.

​
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

1

Create a connector

Go to Connectors and select Add connector.
2

Choose the application

Search for the connector and select it from the list.
3

Enter authentication fields

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.
4

Connect and verify

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

​
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.
1

Open tool settings

Open a connector and select Edit tools.
2

Select a configured tool

Choose a tool that is already configured for the connector.
3

Set default configurations

Add fixed values for required fields, like environment or account IDs.
4

Save the configuration

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.
1

Open the tool's shared tenants

Open a connector, select Edit tools, choose a configured tool, and switch to the Shared Tenants tab.
2

Add a shared tenant

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.
3

Choose an access level

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.