> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpander.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Vtiger CRM

> Connect Vtiger CRM to xpander and give agents its 24 actions: how to create the API key and connect it, and which actions to hold for approval.

<Badge color="blue">HTTP API connector</Badge>

An HTTP API described by an OpenAPI spec, not an MCP server. Calls go to your Vtiger CRM address (`https://{instance}.vtiger.com`, filled in when connecting) and carry HTTP basic authentication with the username and key you enter when connecting.

## What the skill can do

API connector: 24 actions, as they appear in the skill panel. 10 of them create, change or delete something in Vtiger CRM; mark those under **These actions need approval** when you add the skill to an agent.

* **Record lifecycle** (7): Delete Module Record By Id, Create Module Record By Element Type, Update Module Record By Element, Search Module Records By Query, Get Changed Records By Sync Params, Update Record Status By Reopen, Update Module Record By Revise
* **Relationship service** (7): Create Record Relation By Ids, Delete Record Relation By Ids, Metadata Service Get Module Metadata By Describe, Record Lifecycle Get Module Record By Record Id, Get Related Records By Source Id, Search Related Records By Criteria, Get Related Module Types By Module
* **Tagging service** (3): Create Record Tags By Id, Delete Record Tags By Id, Get Record Tags By Id
* **Lead conversion** (1): Create Converted Records By Lead Id
* **Metadata service** (1): Get Accessible Module Types
* **Account hierarchy** (1): Get Account Hierarchy By Account Id
* **Picklist configuration** (1): Get Picklist Dependency By Fields
* **File service** (1): Get File Content By Resource Id
* **Lookup service** (1): Search Records By Email Or Phone
* **Profile service** (1): Get Current User Profile

## Connect Vtiger CRM

In Xpander Chat, open the agent's settings, click **Add skill**, and search for **Vtiger CRM**. The connect dialog asks for a connection name and whether the connection is for the **Organization** (one shared account) or **Personal** (your own account, so the agent acts with your permissions where systems allow). On an agent other people use, a personal connection runs their requests as you unless the binding requires each person's own sign-in; see [whose credential a shared agent uses](/use/agents/permissions#whose-credential-a-shared-agent-uses).

Vtiger CRM connects with an API key. Create the key in Vtiger CRM, paste it into the dialog, and click **Connect**. The key goes to the vault; the agent references it and never sees the value.

Use your Vtiger CRM username and Access Key (found under My Preferences in Vtiger CRM).

Calls go to `https://{instance}.vtiger.com`.

## Give an agent the Vtiger CRM skill

Once Vtiger CRM is connected, any agent you can edit may be given the skill: open the agent's settings, click **Add skill**, and choose **Vtiger CRM**. Enable only the action groups the agent needs, and mark the actions that should wait for a named person's sign-off under **These actions need approval**. Which skills exist for your organization, and who may add them, is decided by your admins; see [Skills](/use/skills).

## Related Resources

* [Skills](/use/skills)