Connect External Apps to Custom Agents

A Custom Agent works with your MoEngage data through the tools you assign to it. Connectors extend that reach to applications outside MoEngage, so a single agent reads a campaign brief from an external file and works with your campaign data in the same run.

​

How Connectors Work

• You connect an application once, not for each agent. After you connect an application on the Connectors page, every agent you run can reach it. Nothing ties a connector to a particular agent, so the agent’s instructions are what decide which application it uses.
• Reach follows the person who starts the run. Each user connects their own account. The same agent works with your data when you run it and with a teammate’s data when they run it, and every agent you run reaches the same set of applications.
• You control which of a connector’s tools stay active. Connecting an application makes its tools available to your agents. Enable or disable individual tools in the connector’s Connection details dialog. A disabled tool remains unavailable to every agent you run.
• Connectors remain separate from MoEngage tools. A connector leaves an agent’s MoEngage tool assignments unchanged, and you manage the two sets independently. For MoEngage tools, refer to Assign Tools.

​

Available Connectors

The Connectors page lists the applications available to your workspace. MoEngage adds applications in later phases of the beta, so check the page for the current list.

​

Connect an Application

Connect the application first, on its own page:

1. In the left navigation menu, go to AI Agents > Connectors.
2. Select the application you want to connect.
3. Complete the application’s sign-in and consent screen. The application then grants MoEngage access to your account.

​

Enable or Disable a Connector’s Tools

Each connector provides its own set of tools, and each tool carries its own status. To control which tools your agents may call:

1. In the left navigation menu, go to AI Agents > Connectors.
2. Select the connected application. MoEngage opens the Connection details dialog, which lists every tool the application provides along with its description and its status, either Enabled or Disabled.
3. Select the checkbox next to each tool you want to change. The action bar reports the number of selected tools. To select all tools, use the checkbox in the table header. To discard the current selection, click Clear selection.
4. Click Enable or Disable. The Status column updates for each selected tool.

A tool’s status belongs to the connector rather than to an individual agent, so it applies to every agent you run. Disable a connector’s write tools when your agents require read access only. To remove the connection altogether, click Disconnect in the Connection details dialog. The agents you run then lose access to the application until you connect it again.

​

Tell an Agent Which Application to Use

A connected application is available to every agent you run, so there is nothing to attach in the builder. The agent’s instructions are what direct it to the right application:

1. Open the agent in the Agent Builder. For a new agent, refer to Create a Custom Agent. For an existing published agent, go to Manage > Edit on the agent’s detail page; for a Draft, click its card on the Custom Agents dashboard.
2. Reference the application in the agent’s instructions: specify which application holds each input, and state what the agent must do with it. For guidance, refer to Configure your Agent’s Instructions.
3. Run a Test agent session to confirm that the agent reaches the application as expected, and then click Make live.

​

Authentication at Run Time

MoEngage resolves connector access against the user who starts a session rather than the user who built the agent. When a teammate runs an agent that uses a connected application, the agent works with that teammate’s account and returns results scoped to it. Connect an application yourself to test the agent against your own account. Each teammate who runs the agent connects their own account to the same application on the Connectors page. For details on how connector access relates to your MoEngage permissions, refer to Custom Agent Essentials: Permissions and Security.

​

Reconnect During a Run

A connector call requires a live connection. If the application is not connected, or the connection drops mid-session, the agent reports that it cannot reach the application and continues without that data. Restoring the connection does not require a new session:

1. Open AI Agents > Connectors in a separate browser tab, and connect or reconnect the application.
2. Return to the session and send your next message.

The agent uses the restored connection from that message onward. Restate any step the agent skipped so that it retries the step.

​

Terms of Usage

The MoEngage AI Terms of Usage Policy governs your use of Connectors. Each connected application remains governed by its provider’s own terms. Review those terms before you connect the application.

​

FAQs