Connector Directory
The Connectors section in the Agent Builder lets you extend an agent's capabilities with optional, per-agent integrations. Connectors are added individually to each agent, so you can tailor what an agent can do based on its purpose.
The Agent Builder includes a connector directory — a browsable catalog of integrations you can add to any agent. Connectors extend what an agent can do: connect to ad platforms, send email, access files, and more. Each connector is added at the per-agent level, which means every agent only has access to the connectors and tools you explicitly grant it.
Unlike tools, which give agents access to NinjaCat-native capabilities, connectors link agents to external systems and services. You choose which connectors to attach to each agent, and then decide — tool by tool — exactly what that agent is allowed to do.
The result: agents that can manage your campaigns, handle communications, and access external data, with trust built in at every level.
Browsing the Connector Directory
To view available connectors for an agent:
- Open the agent in the Agent Builder.
- Navigate to the Connectors section.
- Browse the connector directory to see all available integrations.
Connectors are added individually per agent. Adding a connector to one agent has no effect on any other agent.
Adding a Connector to an Agent
- Open the agent in the Agent Builder.
- Navigate to the Connectors section and open the connector directory.
- Select the connector you want to add.
- Authenticate and authorize the connector (where required) for the relevant account or service.
- Configure tool-level permissions for that connector (see Tool-Level Access Control below).
- Save the agent.
You can add multiple connectors to a single agent, and each is configured independently. You can add, remove, or reconfigure any connector at any time.
Tool-Level Access Control
Connectors are not all-or-nothing. For every connector you add — and for every individual tool within that connector — you set one of three access levels:
| Setting | What it means |
|---|---|
| Allow | The agent can use this tool freely, without any additional approval. |
| Deny | The agent cannot use this tool. It is blocked entirely. |
| Require Approval | Before the agent executes this tool, it must request sign-off from a person. This uses the human-in-the-loop feature. |
Allow and Deny let you precisely scope what each agent can and cannot do. Require Approval adds a human checkpoint — the agent surfaces the proposed action and waits for a person to approve or reject it before proceeding.
Recommended starting point: Set all write tools — anything that changes live data, pauses a campaign, or moves budget — to Require Approval. Once you're confident in how the agent operates, you can selectively switch specific tools to Allow.
This permission model applies to every connector in the directory, including both ad platform connectors and utility connectors like Slack and Google Drive.
Available Connectors
Ad Platform Connectors
New in September 2026 — Google Ads, LinkedIn Ads, Microsoft Advertising (Bing Ads), and Meta Ads are now available as connectors in the Agent Builder's connector directory.
Ad platform connectors extend an agent's capabilities to read and act on live campaign data directly from your ad providers. The following ad platform connectors are available in the connector directory. Each supports both read and write tools, and every tool can be individually set to Allow, Deny, or Require Approval.
Google Ads
Google Ads supports the broadest range of read and write capabilities of any ad platform connector.
Campaigns
| Tool | Type | Description |
|---|---|---|
| List campaigns | Read | Retrieve campaign data and status |
| Pause campaigns | Write | Pause a live campaign |
| Resume campaigns | Write | Resume a paused campaign |
| Create campaigns | Write | Create a new campaign |
| Set campaign budgets | Write | Set a campaign's budget |
| Set campaign bidding strategy | Write | Set the bidding strategy on a campaign |
| List campaign bid adjustments | Read | Retrieve campaign-level bid adjustments |
| Set campaign device bid adjustments | Write | Adjust bids by device at the campaign level |
| Set campaign criterion bid adjustments | Write | Adjust bids for a campaign targeting criterion |
Ad Groups
| Tool | Type | Description |
|---|---|---|
| List ad groups | Read | Retrieve ad group data |
| Create ad groups | Write | Create a new ad group |
| Pause ad groups | Write | Pause an ad group |
| Resume ad groups | Write | Resume a paused ad group |
| Set ad group default max CPC | Write | Set the default max CPC bid for an ad group |
| List ad group bid adjustments | Read | Retrieve ad group-level bid adjustments |
| Set ad group device bid adjustments | Write | Adjust bids by device at the ad group level |
Keywords
| Tool | Type | Description |
|---|---|---|
| List keywords | Read | Retrieve keyword performance data |
| Add keywords | Write | Add keywords to an ad group |
| Pause keywords | Write | Pause a keyword |
| Resume keywords | Write | Resume a paused keyword |
| Set keyword max CPC | Write | Set the max CPC bid on a keyword |
Negative Keywords
| Tool | Type | Description |
|---|---|---|
| List negative keywords | Read | Retrieve negative keywords |
| Add negative keywords | Write | Add negative keywords |
| Remove negative keywords | Write | Remove negative keywords |
Ads
| Tool | Type | Description |
|---|---|---|
| Create responsive search ads | Write | Create a responsive search ad (RSA) |
| Edit RSA text | Write | Edit the text assets of a responsive search ad |
| Set ad status | Write | Change an ad's status |
| Remove ads | Write | Remove an ad |
Portfolio Bidding Strategies
| Tool | Type | Description |
|---|---|---|
| List portfolio bidding strategies | Read | Retrieve portfolio (shared) bidding strategies |
| Create portfolio bidding strategy | Write | Create a portfolio bidding strategy |
| Update portfolio bidding strategy | Write | Update a portfolio bidding strategy |
Meta Ads
Meta Ads supports reading data and writing at both the campaign and ad set level.
Note: Meta uses ad set terminology — this is equivalent to "ad group" in other platforms.
Campaigns
| Tool | Type | Description |
|---|---|---|
| Get campaigns | Read | Retrieve campaign data and status |
| Pause campaign | Write | Pause a live campaign |
| Resume campaign | Write | Resume a paused campaign |
| Adjust campaign budget | Write | Modify a campaign's budget |
Ad Sets
| Tool | Type | Description |
|---|---|---|
| Get ad sets | Read | Retrieve ad set data |
| Pause ad set | Write | Pause an ad set |
| Resume ad set | Write | Resume a paused ad set |
| Adjust ad set budget | Write | Modify an ad set's budget |
Ads
| Tool | Type | Description |
|---|---|---|
| Get ads | Read | Retrieve ad-level data |
| Pause ad | Write | Pause an ad |
| Resume ad | Write | Resume a paused ad |
Microsoft Advertising (Bing Ads)
Microsoft Advertising supports reading data and writing at the campaign, ad group, and ad level. Budgets are set at the campaign level only.
Campaigns
| Tool | Type | Description |
|---|---|---|
| List campaigns | Read | Retrieve campaign data and status |
| Pause campaigns | Write | Pause a live campaign |
| Resume campaigns | Write | Resume a paused campaign |
| Set campaign daily budgets | Write | Set a campaign's daily budget |
Ad Groups
| Tool | Type | Description |
|---|---|---|
| List ad groups | Read | Retrieve ad group data |
| Pause ad groups | Write | Pause an ad group |
| Resume ad groups | Write | Resume a paused ad group |
Ads
| Tool | Type | Description |
|---|---|---|
| List ads | Read | Retrieve ad-level data |
| Pause ads | Write | Pause an ad |
| Resume ads | Write | Resume a paused ad |
LinkedIn Ads
LinkedIn Ads supports reading data and writing at the campaign group, campaign, and ad level.
Note: LinkedIn uses campaign group terminology — this corresponds to what is typically referred to as a "campaign" in other ad platforms.
Campaign Groups
| Tool | Type | Description |
|---|---|---|
| List campaign groups | Read | Retrieve campaign group data |
| Pause campaign groups | Write | Pause a campaign group |
| Resume campaign groups | Write | Resume a paused campaign group |
Campaigns
| Tool | Type | Description |
|---|---|---|
| List campaigns | Read | Retrieve campaign data |
| Pause campaigns | Write | Pause a live campaign |
| Resume campaigns | Write | Resume a paused campaign |
| Set campaign daily budgets | Write | Set a campaign's daily budget |
Creatives (Ads)
| Tool | Type | Description |
|---|---|---|
| List ads | Read | Retrieve ad-level (creative) data |
| Pause ads | Write | Pause an ad |
| Resume ads | Write | Resume a paused ad |
Ad Platform Capabilities at a Glance
| Capability | Google Ads | Meta Ads | Microsoft Advertising | LinkedIn Ads |
|---|---|---|---|---|
| Read campaign data | ✓ | ✓ | ✓ | ✓ |
| Read ad group / ad set / campaign group data | ✓ | ✓ (ad set) | ✓ | ✓ (campaign group) |
| Read ad data | ✓ | ✓ | ✓ | ✓ |
| Read keyword data | ✓ | — | — | — |
| Pause / resume campaigns | ✓ | ✓ | ✓ | ✓ |
| Pause / resume ad groups / ad sets | ✓ | ✓ (ad set) | ✓ | ✓ (campaign group) |
| Pause / resume ads | ✓ | ✓ | ✓ | ✓ |
| Set campaign budgets | ✓ | ✓ | ✓ | ✓ |
| Set ad set budgets | — | ✓ | — | — |
| Create campaigns | ✓ | — | — | — |
| Create ad groups | ✓ | — | — | — |
| Set / adjust bids (campaign, ad group, keyword) | ✓ | — | — | — |
| Manage keywords (add / pause / resume) | ✓ | — | — | — |
| Manage negative keywords | ✓ | — | — | — |
| Manage ads (create RSAs, edit, status, remove) | ✓ | — | — | — |
| Portfolio bidding strategies | ✓ | — | — | — |
Send Email
The Send Email connector lets an agent send emails on demand using your organization's existing SMTP configuration.
- Emails are sent using the SMTP settings configured for your organization in NinjaCat.
- No additional authentication is required at the agent level — if SMTP is already set up for your org, the connector is ready to use.
- The agent can send email to any recipient, including external (non-NinjaCat) addresses, when instructed to do so as part of its task.
Google Drive
The Google Drive connector lets an agent interact with files in a Google Drive that has already been connected to NinjaCat.
Prerequisite: connect Google Drive at the org level first
The Google Drive connector reuses existing OAuth credentials authorized through Network and Data Cloud → Connectors in NinjaCat. You must connect your Google Drive there first. Once connected at the org level, it becomes available to add to any agent.
Permission modes
When adding the Google Drive connector to an agent, you choose the level of access the agent has:
| Permission | What the agent can do |
|---|---|
| Read only | Search and read files |
| Read and create | Search and read files, plus create new files |
| Custom | Fine-grained selection, including searching, reading, creating, and managing files |
Choose the most restrictive permission level that still lets the agent do its job.
Managing Connectors
Connectors are configured per agent — changing a connector on one agent does not affect any other agent. To update or remove a connector:
- Open the agent in the Agent Builder.
- Go to the Connectors section.
- Edit the connector's settings, adjust tool permissions, or remove it entirely.
Best Practices
- Connect only what the agent needs. Each connector is per-agent, so an agent that only reads data for reporting does not need write tools enabled.
- Use Require Approval for write tools by default. Budget changes, campaign pauses, and other write actions affect live accounts — a human checkpoint prevents unintended changes.
- Revisit permissions when an agent's role expands. If the scope of an agent changes, review its connector permissions to make sure they still match what you intend.
- Separate read-only agents from action-taking agents. Consider maintaining distinct agents for analytics (read-only tools) and campaign management (write tools enabled) for cleaner accountability and auditability.
Related
- Adding Tools — enable NinjaCat-native capabilities for an agent
- Connecting Agents to Slack — add the Slack connector and configure its tool permissions
- Create an Agent with the Agent Builder — full Agent Builder walkthrough
Updated about 1 month ago