# Vtiger CRM

> Work with your Vtiger CRM: create, find, update and delete leads, contacts, organizations, deals, tickets and tasks, read or change records of any other module, run queries, and add comments to a record's history.

App · 23 actions. Web page: https://docs.lodol.com/docs/integrations/vtiger-crm

## Actions

### Add comment

Add a comment to a record's history, such as a lead, contact, organization, deal or ticket.

**Inputs**

- Record (`related_to`, text, required): The id of the record to comment on, such as 4x123, from an earlier step.
- Comment (`comment`, text, required): What to say.
- Assigned to (`assigned_to`, text): The user or group that owns the record. Pick one, or give an id from 'List users and groups'. Defaults to the connected user.

**Outputs**

- `comment` (object): The comment added

**Example output**

```json
{
  "comment": {
    "assigned_user_id": "19x1",
    "commentcontent": "Spoke to Alex; sending a quote.",
    "createdtime": "2026-10-20 09:15:00",
    "id": "10x42",
    "modifiedtime": "2026-10-21 14:02:10",
    "related_to": "3x12"
  }
}
```

### Create contact

Create a contact in Vtiger. Fill in what you know; it is assigned to the connected user unless you choose someone else.

**Inputs**

- Last name (`last_name`, text, required): The contact's last name.
- First name (`first_name`, text): The contact's first name.
- Salutation (`salutation`, text): How to address the contact. One of: `Mr.`, `Ms.`, `Mrs.`, `Dr.`, `Prof.`.
- Email (`email`, text): The contact's email address.
- Phone (`phone`, text): The contact's phone number.
- Mobile (`mobile`, text): The contact's mobile number.
- Job title (`job_title`, text): The contact's job title. Pick one, or type a title your instance uses.
- Department (`department`, text): The contact's department.
- Organization (`account_id`, text): The organization the contact works for. Pick one, or give the id of an organization from an earlier step.
- Lead source (`lead_source`, text): Where the contact came from. Pick one, or type a source your instance uses.
- Birthday (`birthday`, date): The contact's date of birth.
- Street (`street`, text): The mailing street address.
- City (`city`, text): The mailing city.
- State (`state`, text): The mailing state or region.
- Postal code (`postal_code`, text): The mailing postal or ZIP code.
- Country (`country`, text): The mailing country.
- Description (`description`, text): Notes about the record.
- Assigned to (`assigned_to`, text): The user or group that owns the record. Pick one, or give an id from 'List users and groups'. Defaults to the connected user.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "contact": {
    "account_id": "3x12",
    "assigned_user_id": "19x1",
    "createdtime": "2026-10-20 09:15:00",
    "email": "alex.smith@example.com",
    "firstname": "Alex",
    "id": "10x42",
    "lastname": "Smith",
    "modifiedtime": "2026-10-21 14:02:10",
    "phone": "+1 555 0100",
    "title": "Head of Operations"
  }
}
```

### Create deal

Create a deal in Vtiger. Fill in what you know; it is assigned to the connected user unless you choose someone else.

**Inputs**

- Deal name (`name`, text, required): The deal's name.
- Organization (`related_to`, text, required): The organization the deal is with. Pick one, or give the id of an organization or contact from an earlier step.
- Expected close date (`closing_date`, date, required): When the deal is expected to close.
- Sales stage (`sales_stage`, text, required): Where the deal is in your pipeline. Pick one, or type a stage your instance uses.
- Amount (`amount`, number): The deal's value, as a number.
- Probability (%) (`probability`, number): The chance of winning, from 0 to 100. From 0 to 100.
- Lead source (`lead_source`, text): Where the deal came from. Pick one, or type a source your instance uses.
- Next step (`next_step`, text): What happens next.
- Description (`description`, text): Notes about the record.
- Assigned to (`assigned_to`, text): The user or group that owns the record. Pick one, or give an id from 'List users and groups'. Defaults to the connected user.

**Outputs**

- `deal` (object): The deal

**Example output**

```json
{
  "deal": {
    "amount": "15000.00",
    "assigned_user_id": "19x1",
    "closingdate": "2026-12-31",
    "createdtime": "2026-10-20 09:15:00",
    "id": "10x42",
    "modifiedtime": "2026-10-21 14:02:10",
    "potentialname": "Acme renewal",
    "probability": "40",
    "related_to": "3x12",
    "sales_stage": "Prospecting"
  }
}
```

### Create lead

Create a lead in Vtiger. Fill in what you know; it is assigned to the connected user unless you choose someone else.

**Inputs**

- Last name (`last_name`, text, required): The lead's last name.
- First name (`first_name`, text): The lead's first name.
- Salutation (`salutation`, text): How to address the lead. One of: `Mr.`, `Ms.`, `Mrs.`, `Dr.`, `Prof.`.
- Company (`company`, text): The company the lead works for.
- Email (`email`, text): The lead's email address.
- Phone (`phone`, text): The lead's phone number.
- Mobile (`mobile`, text): The lead's mobile number.
- Job title (`job_title`, text): The lead's job title. Pick one, or type a title your instance uses.
- Website (`website`, text): The lead's website.
- Lead status (`lead_status`, text): Where the lead is in your process. Pick one, or type a status your instance uses.
- Lead source (`lead_source`, text): Where the lead came from. Pick one, or type a source your instance uses.
- Industry (`industry`, text): The lead's industry. Pick one, or type an industry your instance uses.
- Annual revenue (`annual_revenue`, number): The company's yearly revenue, as a number.
- Number of employees (`employees`, number): How many people work at the company. At least 0.
- Street (`street`, text): The street address.
- City (`city`, text): The city.
- State (`state`, text): The state or region.
- Postal code (`postal_code`, text): The postal or ZIP code.
- Country (`country`, text): The country.
- Description (`description`, text): Notes about the record.
- Assigned to (`assigned_to`, text): The user or group that owns the record. Pick one, or give an id from 'List users and groups'. Defaults to the connected user.

**Outputs**

- `lead` (object): The lead

**Example output**

```json
{
  "lead": {
    "assigned_user_id": "19x1",
    "company": "Acme Ltd",
    "createdtime": "2026-10-20 09:15:00",
    "email": "alex.smith@example.com",
    "firstname": "Alex",
    "id": "10x42",
    "lastname": "Smith",
    "leadstatus": "Contacted",
    "modifiedtime": "2026-10-21 14:02:10",
    "phone": "+1 555 0100"
  }
}
```

### Create organization

Create a organization in Vtiger. Fill in what you know; it is assigned to the connected user unless you choose someone else.

**Inputs**

- Organization name (`name`, text, required): The organization's name.
- Website (`website`, text): The organization's website.
- Email (`email`, text): The organization's main email address.
- Phone (`phone`, text): The organization's main phone number.
- Industry (`industry`, text): The organization's industry. Pick one, or type an industry your instance uses.
- Type (`account_type`, text): What kind of organization it is, such as Customer or Partner. Pick one, or type a type your instance uses.
- Number of employees (`employees`, number): How many people work there. At least 0.
- Annual revenue (`annual_revenue`, number): The organization's yearly revenue, as a number.
- Billing street (`street`, text): The billing street address.
- Billing city (`city`, text): The billing city.
- Billing state (`state`, text): The billing state or region.
- Billing postal code (`postal_code`, text): The billing postal or ZIP code.
- Billing country (`country`, text): The billing country.
- Description (`description`, text): Notes about the record.
- Assigned to (`assigned_to`, text): The user or group that owns the record. Pick one, or give an id from 'List users and groups'. Defaults to the connected user.

**Outputs**

- `organization` (object): The organization

**Example output**

```json
{
  "organization": {
    "accountname": "Acme Ltd",
    "assigned_user_id": "19x1",
    "createdtime": "2026-10-20 09:15:00",
    "email1": "info@acme.example.com",
    "id": "10x42",
    "industry": "Technology",
    "modifiedtime": "2026-10-21 14:02:10",
    "phone": "+1 555 0100",
    "website": "https://acme.example.com"
  }
}
```

### Create record

Create a record in any module from a list of fields, for a module without its own create action. It is assigned to the connected user unless 'assigned_user_id' is given.

**Inputs**

- Module (`module`, text, required): The kind of record, such as Leads, Contacts, Accounts (organizations), Potentials (deals), HelpDesk (tickets) or Calendar (tasks). Pick one, or type a module's name.
- Fields (`fields`, object, required): The fields to set, each a field name and its value, such as lastname and Smith. 'Describe module' lists a module's field names; dates are YYYY-MM-DD and yes/no fields are true or false.

**Outputs**

- `record` (object): The record created

**Example output**

```json
{
  "record": {
    "assigned_user_id": "19x1",
    "createdtime": "2026-10-20 09:15:00",
    "id": "10x42",
    "modifiedtime": "2026-10-21 14:02:10"
  }
}
```

### Create task

Create a task in Vtiger. Fill in what you know; it is assigned to the connected user unless you choose someone else.

**Inputs**

- Subject (`subject`, text, required): What needs doing.
- Start date (`start_date`, date, required): The day the task starts.
- Start time (`start_time`, time): The time the task starts. Defaults to 09:00.
- Due date (`due_date`, date): The day the task is due. Defaults to the start date.
- Status (`status`, text): Where the task is. Pick one, or type a status your instance uses. Defaults to Not Started.
- Priority (`priority`, text): How urgent the task is. Pick one, or type a priority your instance uses.
- Related to (`related_to`, text): The id of the lead, deal or ticket the task is about, from an earlier step. Older Vtiger versions also accept an organization; newer ones do not.
- Contact (`contact_id`, text): The id of the contact the task is about, from an earlier step.
- Description (`description`, text): Notes about the task.
- Assigned to (`assigned_to`, text): The user or group that owns the record. Pick one, or give an id from 'List users and groups'. Defaults to the connected user.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "task": {
    "assigned_user_id": "19x1",
    "createdtime": "2026-10-20 09:15:00",
    "date_start": "2026-11-02",
    "due_date": "2026-11-02",
    "id": "10x42",
    "modifiedtime": "2026-10-21 14:02:10",
    "subject": "Call Alex about the renewal",
    "taskpriority": "Medium",
    "taskstatus": "Not Started",
    "time_start": "09:00:00"
  }
}
```

### Create ticket

Create a ticket in Vtiger. Fill in what you know; it is assigned to the connected user unless you choose someone else.

**Inputs**

- Title (`title`, text, required): A short summary of the problem.
- Status (`status`, text): Where the ticket is. Pick one, or type a status your instance uses. Defaults to Open.
- Priority (`priority`, text): How urgent the ticket is. Pick one, or type a priority your instance uses.
- Organization (`account_id`, text): The organization the ticket is for. Pick one, or give the id of an organization or contact from an earlier step.
- Contact (`contact_id`, text): The id of the contact who raised it, from an earlier step. Newer Vtiger versions require it.
- Description (`description`, text): The details of the problem. Newer Vtiger versions require it.
- Solution (`solution`, text): How the problem was solved. Not kept by newer Vtiger versions, which call tickets Cases.
- Assigned to (`assigned_to`, text): The user or group that owns the record. Pick one, or give an id from 'List users and groups'. Defaults to the connected user.

**Outputs**

- `ticket` (object): The ticket

**Example output**

```json
{
  "ticket": {
    "assigned_user_id": "19x1",
    "createdtime": "2026-10-20 09:15:00",
    "id": "10x42",
    "modifiedtime": "2026-10-21 14:02:10",
    "ticket_no": "TT12",
    "ticket_title": "Cannot sign in",
    "ticketpriorities": "Normal",
    "ticketstatus": "Open"
  }
}
```

### Delete record

Delete a record of any module. Vtiger moves it to its Recycle Bin, from where it can be restored.

**Inputs**

- Record ID (`record_id`, text, required): The record's id, such as 4x123, from 'List records' or the 'id' of an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `record_id` (text): The record deleted

**Example output**

```json
{
  "deleted": true,
  "record_id": "10x42"
}
```

### Describe module

List a module's fields: the names to use in 'Create record' and 'List records', their types, which are required, and the values of picklists.

**Inputs**

- Module (`module`, text, required): The kind of record, such as Leads, Contacts, Accounts (organizations), Potentials (deals), HelpDesk (tickets) or Calendar (tasks). Pick one, or type a module's name.

**Outputs**

- `can_create` (true/false): Whether you can create records
- `can_delete` (true/false): Whether you can delete records
- `can_update` (true/false): Whether you can change records
- `field_count` (number): How many fields
- `fields` (list): The fields
- `id_prefix` (text): The number its record ids start with
- `label` (text): The name people see
- `name` (text): The module's name

**Example output**

```json
{
  "can_create": true,
  "can_delete": true,
  "can_update": true,
  "field_count": 1,
  "fields": [
    {
      "editable": true,
      "label": "Last Name",
      "mandatory": true,
      "name": "lastname",
      "picklist_values": [],
      "type": "string"
    }
  ],
  "id_prefix": "10",
  "label": "Leads",
  "name": "Leads"
}
```

### Get current user

Get the Vtiger user the connection signs in as, and the version of Vtiger it runs.

**Inputs**: None.

**Outputs**

- `user` (object): The connected user
- `vtiger_version` (text): The Vtiger version, such as 7.5.0
- `webservice_version` (text): The web service version, such as 0.22

**Example output**

```json
{
  "user": {
    "email1": "alex.smith@example.com",
    "first_name": "Alex",
    "id": "19x1",
    "last_name": "Smith",
    "status": "Active",
    "user_name": "admin"
  },
  "vtiger_version": "7.5.0",
  "webservice_version": "0.22"
}
```

### Get record

Get one record of any module with all its fields.

**Inputs**

- Record ID (`record_id`, text, required): The record's id, such as 4x123, from 'List records' or the 'id' of an earlier step.

**Outputs**

- `record` (object): The record

**Example output**

```json
{
  "record": {
    "assigned_user_id": "19x1",
    "createdtime": "2026-10-20 09:15:00",
    "id": "10x42",
    "modifiedtime": "2026-10-21 14:02:10"
  }
}
```

### List modules

List the modules that hold records in this Vtiger, including custom ones.

**Inputs**: None.

**Outputs**

- `count` (number): How many modules
- `modules` (list): The modules

**Example output**

```json
{
  "count": 1,
  "modules": [
    {
      "is_entity": true,
      "label": "Leads",
      "name": "Leads",
      "singular_label": "Lead"
    }
  ]
}
```

### List records

List records of any module, one page at a time, optionally filtered on a field or to those changed or created since a moment.

**Inputs**

- Module (`module`, text, required): The kind of record, such as Leads, Contacts, Accounts (organizations), Potentials (deals), HelpDesk (tickets) or Calendar (tasks). Pick one, or type a module's name.
- Fields to return (`fields`, list): Only these fields. Leave empty for every field.
- Filter field (`filter_field`, text): The field to filter on, such as email or leadstatus.
- Filter (`filter_operator`, text): How to compare the field with the value. Defaults to equals. One of: `equals` (Equals (default)), `not_equals` (Does not equal), `contains`, `starts_with` (Starts with), `greater_than` (Greater than), `greater_or_equal` (Greater than or equal to), `less_than` (Less than), `less_or_equal` (Less than or equal to).
- Filter value (`filter_value`, text): The value to compare with. Dates are YYYY-MM-DD.
- Changed since (`modified_since`, date and time): Only records changed at or after this moment.
- Created since (`created_since`, date and time): Only records created at or after this moment.
- Sort by (`order_by`, text): The field to sort by, such as createdtime. Defaults to Vtiger's order.
- Sort order (`order_direction`, text): Which end to start from when sorting. Defaults to smallest first. One of: `asc` (Smallest first (default)), `desc` (Largest first).
- Page size (`limit`, number): How many records to return, 1 to 100. Defaults to 25. From 1 to 100.
- Start at (`offset`, number): How many records to skip: the 'next_offset' of an earlier page. At least 0.

**Outputs**

- `count` (number): How many records this page holds
- `has_more` (true/false): Whether another page follows
- `module` (text): The module listed
- `next_offset` (number): The 'Start at' for the next page, or 0 when there is none
- `records` (list): The records

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "module": "Leads",
  "next_offset": 0,
  "records": [
    {
      "assigned_user_id": "19x1",
      "createdtime": "2026-10-20 09:15:00",
      "id": "10x42",
      "modifiedtime": "2026-10-21 14:02:10"
    }
  ]
}
```

### List users and groups

List the users and groups a record can be assigned to, with the ids to give 'Assigned to'.

**Inputs**: None.

**Outputs**

- `group_count` (number): How many groups
- `groups` (list): The groups
- `user_count` (number): How many users
- `users` (list): The users

**Example output**

```json
{
  "group_count": 1,
  "groups": [
    {
      "id": "20x3",
      "name": "Support"
    }
  ],
  "user_count": 1,
  "users": [
    {
      "email": "alex.smith@example.com",
      "id": "19x1",
      "is_admin": true,
      "name": "Alex Smith",
      "status": "Active",
      "user_name": "admin"
    }
  ]
}
```

### Run query

Run a read-only VtigerQL query, such as SELECT firstname, lastname FROM Contacts WHERE email LIKE '%acme%' LIMIT 0, 50. Vtiger returns at most 100 rows.

**Inputs**

- Query (`query`, text, required): A single SELECT in VtigerQL, Vtiger's SQL-like language. It cannot join modules.

**Outputs**

- `count` (number): How many rows came back
- `records` (list): The rows

**Example output**

```json
{
  "count": 1,
  "records": [
    {
      "assigned_user_id": "19x1",
      "createdtime": "2026-10-20 09:15:00",
      "id": "10x42",
      "modifiedtime": "2026-10-21 14:02:10"
    }
  ]
}
```

### Update contact

Change a contact in Vtiger. Only the fields you fill in change; the rest stay as they are.

**Inputs**

- Contact (`record_id`, text, required): The contact's id, such as 4x123, from 'Create contact', 'List records' or an earlier step.
- Last name (`last_name`, text): The contact's last name.
- First name (`first_name`, text): The contact's first name.
- Salutation (`salutation`, text): How to address the contact. One of: `Mr.`, `Ms.`, `Mrs.`, `Dr.`, `Prof.`.
- Email (`email`, text): The contact's email address.
- Phone (`phone`, text): The contact's phone number.
- Mobile (`mobile`, text): The contact's mobile number.
- Job title (`job_title`, text): The contact's job title. Pick one, or type a title your instance uses.
- Department (`department`, text): The contact's department.
- Organization (`account_id`, text): The organization the contact works for. Pick one, or give the id of an organization from an earlier step.
- Lead source (`lead_source`, text): Where the contact came from. Pick one, or type a source your instance uses.
- Birthday (`birthday`, date): The contact's date of birth.
- Street (`street`, text): The mailing street address.
- City (`city`, text): The mailing city.
- State (`state`, text): The mailing state or region.
- Postal code (`postal_code`, text): The mailing postal or ZIP code.
- Country (`country`, text): The mailing country.
- Description (`description`, text): Notes about the record.
- Assigned to (`assigned_to`, text): The user or group that owns the record. Pick one, or give an id from 'List users and groups'. Defaults to the connected user.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "contact": {
    "account_id": "3x12",
    "assigned_user_id": "19x1",
    "createdtime": "2026-10-20 09:15:00",
    "email": "alex.smith@example.com",
    "firstname": "Alex",
    "id": "10x42",
    "lastname": "Smith",
    "modifiedtime": "2026-10-21 14:02:10",
    "phone": "+1 555 0100",
    "title": "Head of Operations"
  }
}
```

### Update deal

Change a deal in Vtiger. Only the fields you fill in change; the rest stay as they are.

**Inputs**

- Deal (`record_id`, text, required): The deal's id, such as 4x123, from 'Create deal', 'List records' or an earlier step.
- Deal name (`name`, text): The deal's name.
- Organization (`related_to`, text): The organization the deal is with. Pick one, or give the id of an organization or contact from an earlier step.
- Expected close date (`closing_date`, date): When the deal is expected to close.
- Sales stage (`sales_stage`, text): Where the deal is in your pipeline. Pick one, or type a stage your instance uses.
- Amount (`amount`, number): The deal's value, as a number.
- Probability (%) (`probability`, number): The chance of winning, from 0 to 100. From 0 to 100.
- Lead source (`lead_source`, text): Where the deal came from. Pick one, or type a source your instance uses.
- Next step (`next_step`, text): What happens next.
- Description (`description`, text): Notes about the record.
- Assigned to (`assigned_to`, text): The user or group that owns the record. Pick one, or give an id from 'List users and groups'. Defaults to the connected user.

**Outputs**

- `deal` (object): The deal

**Example output**

```json
{
  "deal": {
    "amount": "15000.00",
    "assigned_user_id": "19x1",
    "closingdate": "2026-12-31",
    "createdtime": "2026-10-20 09:15:00",
    "id": "10x42",
    "modifiedtime": "2026-10-21 14:02:10",
    "potentialname": "Acme renewal",
    "probability": "40",
    "related_to": "3x12",
    "sales_stage": "Prospecting"
  }
}
```

### Update lead

Change a lead in Vtiger. Only the fields you fill in change; the rest stay as they are.

**Inputs**

- Lead (`record_id`, text, required): The lead's id, such as 4x123, from 'Create lead', 'List records' or an earlier step.
- Last name (`last_name`, text): The lead's last name.
- First name (`first_name`, text): The lead's first name.
- Salutation (`salutation`, text): How to address the lead. One of: `Mr.`, `Ms.`, `Mrs.`, `Dr.`, `Prof.`.
- Company (`company`, text): The company the lead works for.
- Email (`email`, text): The lead's email address.
- Phone (`phone`, text): The lead's phone number.
- Mobile (`mobile`, text): The lead's mobile number.
- Job title (`job_title`, text): The lead's job title. Pick one, or type a title your instance uses.
- Website (`website`, text): The lead's website.
- Lead status (`lead_status`, text): Where the lead is in your process. Pick one, or type a status your instance uses.
- Lead source (`lead_source`, text): Where the lead came from. Pick one, or type a source your instance uses.
- Industry (`industry`, text): The lead's industry. Pick one, or type an industry your instance uses.
- Annual revenue (`annual_revenue`, number): The company's yearly revenue, as a number.
- Number of employees (`employees`, number): How many people work at the company. At least 0.
- Street (`street`, text): The street address.
- City (`city`, text): The city.
- State (`state`, text): The state or region.
- Postal code (`postal_code`, text): The postal or ZIP code.
- Country (`country`, text): The country.
- Description (`description`, text): Notes about the record.
- Assigned to (`assigned_to`, text): The user or group that owns the record. Pick one, or give an id from 'List users and groups'. Defaults to the connected user.

**Outputs**

- `lead` (object): The lead

**Example output**

```json
{
  "lead": {
    "assigned_user_id": "19x1",
    "company": "Acme Ltd",
    "createdtime": "2026-10-20 09:15:00",
    "email": "alex.smith@example.com",
    "firstname": "Alex",
    "id": "10x42",
    "lastname": "Smith",
    "leadstatus": "Contacted",
    "modifiedtime": "2026-10-21 14:02:10",
    "phone": "+1 555 0100"
  }
}
```

### Update organization

Change a organization in Vtiger. Only the fields you fill in change; the rest stay as they are.

**Inputs**

- Organization (`record_id`, text, required): The organization's id, such as 4x123, from 'Create organization', 'List records' or an earlier step.
- Organization name (`name`, text): The organization's name.
- Website (`website`, text): The organization's website.
- Email (`email`, text): The organization's main email address.
- Phone (`phone`, text): The organization's main phone number.
- Industry (`industry`, text): The organization's industry. Pick one, or type an industry your instance uses.
- Type (`account_type`, text): What kind of organization it is, such as Customer or Partner. Pick one, or type a type your instance uses.
- Number of employees (`employees`, number): How many people work there. At least 0.
- Annual revenue (`annual_revenue`, number): The organization's yearly revenue, as a number.
- Billing street (`street`, text): The billing street address.
- Billing city (`city`, text): The billing city.
- Billing state (`state`, text): The billing state or region.
- Billing postal code (`postal_code`, text): The billing postal or ZIP code.
- Billing country (`country`, text): The billing country.
- Description (`description`, text): Notes about the record.
- Assigned to (`assigned_to`, text): The user or group that owns the record. Pick one, or give an id from 'List users and groups'. Defaults to the connected user.

**Outputs**

- `organization` (object): The organization

**Example output**

```json
{
  "organization": {
    "accountname": "Acme Ltd",
    "assigned_user_id": "19x1",
    "createdtime": "2026-10-20 09:15:00",
    "email1": "info@acme.example.com",
    "id": "10x42",
    "industry": "Technology",
    "modifiedtime": "2026-10-21 14:02:10",
    "phone": "+1 555 0100",
    "website": "https://acme.example.com"
  }
}
```

### Update record

Change fields of a record in any module. Only the fields you list change; the rest stay as they are.

**Inputs**

- Record ID (`record_id`, text, required): The record's id, such as 4x123, from 'List records' or the 'id' of an earlier step.
- Fields (`fields`, object, required): The fields to set, each a field name and its value, such as lastname and Smith. 'Describe module' lists a module's field names; dates are YYYY-MM-DD and yes/no fields are true or false.

**Outputs**

- `record` (object): The record, changed

**Example output**

```json
{
  "record": {
    "assigned_user_id": "19x1",
    "createdtime": "2026-10-20 09:15:00",
    "id": "10x42",
    "modifiedtime": "2026-10-21 14:02:10"
  }
}
```

### Update task

Change a task in Vtiger. Only the fields you fill in change; the rest stay as they are.

**Inputs**

- Task (`record_id`, text, required): The task's id, such as 4x123, from 'Create task', 'List records' or an earlier step.
- Subject (`subject`, text): What needs doing.
- Start date (`start_date`, date): The day the task starts.
- Start time (`start_time`, time): The time the task starts. Defaults to 09:00.
- Due date (`due_date`, date): The day the task is due. Defaults to the start date.
- Status (`status`, text): Where the task is. Pick one, or type a status your instance uses. Defaults to Not Started.
- Priority (`priority`, text): How urgent the task is. Pick one, or type a priority your instance uses.
- Related to (`related_to`, text): The id of the lead, deal or ticket the task is about, from an earlier step. Older Vtiger versions also accept an organization; newer ones do not.
- Contact (`contact_id`, text): The id of the contact the task is about, from an earlier step.
- Description (`description`, text): Notes about the task.
- Assigned to (`assigned_to`, text): The user or group that owns the record. Pick one, or give an id from 'List users and groups'. Defaults to the connected user.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "task": {
    "assigned_user_id": "19x1",
    "createdtime": "2026-10-20 09:15:00",
    "date_start": "2026-11-02",
    "due_date": "2026-11-02",
    "id": "10x42",
    "modifiedtime": "2026-10-21 14:02:10",
    "subject": "Call Alex about the renewal",
    "taskpriority": "Medium",
    "taskstatus": "Not Started",
    "time_start": "09:00:00"
  }
}
```

### Update ticket

Change a ticket in Vtiger. Only the fields you fill in change; the rest stay as they are.

**Inputs**

- Ticket (`record_id`, text, required): The ticket's id, such as 4x123, from 'Create ticket', 'List records' or an earlier step.
- Title (`title`, text): A short summary of the problem.
- Status (`status`, text): Where the ticket is. Pick one, or type a status your instance uses. Defaults to Open.
- Priority (`priority`, text): How urgent the ticket is. Pick one, or type a priority your instance uses.
- Organization (`account_id`, text): The organization the ticket is for. Pick one, or give the id of an organization or contact from an earlier step.
- Contact (`contact_id`, text): The id of the contact who raised it, from an earlier step. Newer Vtiger versions require it.
- Description (`description`, text): The details of the problem. Newer Vtiger versions require it.
- Solution (`solution`, text): How the problem was solved. Not kept by newer Vtiger versions, which call tickets Cases.
- Assigned to (`assigned_to`, text): The user or group that owns the record. Pick one, or give an id from 'List users and groups'. Defaults to the connected user.

**Outputs**

- `ticket` (object): The ticket

**Example output**

```json
{
  "ticket": {
    "assigned_user_id": "19x1",
    "createdtime": "2026-10-20 09:15:00",
    "id": "10x42",
    "modifiedtime": "2026-10-21 14:02:10",
    "ticket_no": "TT12",
    "ticket_title": "Cannot sign in",
    "ticketpriorities": "Normal",
    "ticketstatus": "Open"
  }
}
```
