This connector is optimized for AI agents. For the data replication connector, see Zoho Crm .
This is the full reference documentation for the Zoho-Crm agent connector.
Supported entities and actions
The Zoho-Crm connector supports the following entities and actions.
Entity Actions Leads List , Create , Get , Update , Context Store Search Contacts List , Create , Get , Update , Context Store Search Accounts List , Create , Get , Update , Context Store Search Deals List , Create , Get , Update , Context Store Search Campaigns List , Get , Context Store Search Tasks List , Create , Get , Update , Context Store Search Events List , Get , Context Store Search Calls List , Get , Context Store Search Products List , Get , Context Store Search Quotes List , Get , Context Store Search Invoices List , Get , Context Store Search
Leads
Leads List
Returns a paginated list of leads
Python SDK
await zoho_crm . leads . list ( )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "leads", "action": "list" }'
Parameters
Parameter Name Type Required Description pageintegerNo Page number per_pageintegerNo Number of records per page page_tokenstringNo Page token for fetching beyond 2000 records sort_bystringNo Field to sort by sort_order"asc" | "desc"No Sort order
Response Schema Records Field Name Type Description idstringOwnerobject | anyCompanynull | stringFirst_Namenull | stringLast_Namenull | stringFull_Namenull | stringEmailnull | stringPhonenull | stringMobilenull | stringFaxnull | stringTitlenull | stringLead_Sourcenull | stringIndustrynull | stringAnnual_Revenuenull | numberNo_of_Employeesnull | integerRatingnull | stringLead_Statusnull | stringWebsitenull | stringStreetnull | stringCitynull | stringStatenull | stringZip_Codenull | stringCountrynull | stringDescriptionnull | stringConverted_Detailnull | objectCreated_Timenull | stringModified_Timenull | stringCreated_Byobject | anyModified_Byobject | anyRecord_Status__snull | string
Field Name Type Description more_recordsbooleanpageinteger
Leads Create
Creates a new lead record in Zoho CRM
Python SDK
await zoho_crm . leads . create ( data = [ ] )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "leads", "action": "create", "params": { "data": [] } }'
Parameters
Parameter Name Type Required Description dataarray<object>Yes Array containing the lead record to create data.First_NamestringNo Lead's first name data.Last_NamestringYes Lead's last name (required) data.EmailstringNo Lead's email address data.PhonestringNo Lead's phone number data.MobilestringNo Lead's mobile number data.CompanystringNo Company the lead is associated with data.TitlestringNo Lead's job title data.Lead_SourcestringNo Source from which the lead was generated data.IndustrystringNo Industry the lead belongs to data.Annual_RevenuenumberNo Annual revenue of the lead's company data.No_of_EmployeesintegerNo Number of employees in the lead's company data.RatingstringNo Lead rating data.Lead_StatusstringNo Current status of the lead data.WebsitestringNo Lead's website URL data.StreetstringNo Street address data.CitystringNo City data.StatestringNo State or province data.Zip_CodestringNo ZIP/postal code data.CountrystringNo Country data.DescriptionstringNo Description or notes about the lead
Response Schema Records Field Name Type Description dataarray<object>data[].codestringdata[].detailsobjectdata[].details.Modified_Timenull | stringdata[].details.Modified_Byobject | anydata[].details.Created_Timenull | stringdata[].details.idstringdata[].details.Created_Byobject | anydata[].messagestringdata[].statusstring
Leads Get
Get a single lead by ID
Python SDK
await zoho_crm . leads . get ( id = "<str>" )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "leads", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes Lead ID
Leads Update
Updates an existing lead record in Zoho CRM
Python SDK
await zoho_crm . leads . update ( data = [ ] , id = "<str>" )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "leads", "action": "update", "params": { "data": [], "id": "<str>" } }'
Parameters
Parameter Name Type Required Description dataarray<object>Yes Array containing the lead fields to update data.First_NamestringNo Lead's first name data.Last_NamestringNo Lead's last name data.EmailstringNo Lead's email address data.PhonestringNo Lead's phone number data.MobilestringNo Lead's mobile number data.CompanystringNo Company the lead is associated with data.TitlestringNo Lead's job title data.Lead_SourcestringNo Source from which the lead was generated data.IndustrystringNo Industry the lead belongs to data.Annual_RevenuenumberNo Annual revenue of the lead's company data.No_of_EmployeesintegerNo Number of employees in the lead's company data.RatingstringNo Lead rating data.Lead_StatusstringNo Current status of the lead data.WebsitestringNo Lead's website URL data.StreetstringNo Street address data.CitystringNo City data.StatestringNo State or province data.Zip_CodestringNo ZIP/postal code data.CountrystringNo Country data.DescriptionstringNo Description or notes about the lead idstringYes Lead ID
Response Schema Records Field Name Type Description dataarray<object>data[].codestringdata[].detailsobjectdata[].details.Modified_Timenull | stringdata[].details.Modified_Byobject | anydata[].details.Created_Timenull | stringdata[].details.idstringdata[].details.Created_Byobject | anydata[].messagestringdata[].statusstring
Leads Context Store Search
Search and filter leads records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await zoho_crm . leads . context_store_search ( query = { "filter" : { "eq" : { "id" : "<str>" } } } )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "leads", "action": "context_store_search", "params": { "query": {"filter": {"eq": {"id": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idstringUnique record identifier First_NamestringLead's first name Last_NamestringLead's last name Full_NamestringLead's full name EmailstringLead's email address PhonestringLead's phone number MobilestringLead's mobile number CompanystringCompany the lead is associated with TitlestringLead's job title Lead_SourcestringSource from which the lead was generated IndustrystringIndustry the lead belongs to Annual_RevenuenumberAnnual revenue of the lead's company No_of_EmployeesintegerNumber of employees in the lead's company RatingstringLead rating Lead_StatusstringCurrent status of the lead WebsitestringLead's website URL CitystringLead's city StatestringLead's state or province CountrystringLead's country DescriptionstringDescription or notes about the lead Created_TimestringTime the record was created Modified_TimestringTime the record was last modified
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idstringUnique record identifier data[].First_NamestringLead's first name data[].Last_NamestringLead's last name data[].Full_NamestringLead's full name data[].EmailstringLead's email address data[].PhonestringLead's phone number data[].MobilestringLead's mobile number data[].CompanystringCompany the lead is associated with data[].TitlestringLead's job title data[].Lead_SourcestringSource from which the lead was generated data[].IndustrystringIndustry the lead belongs to data[].Annual_RevenuenumberAnnual revenue of the lead's company data[].No_of_EmployeesintegerNumber of employees in the lead's company data[].RatingstringLead rating data[].Lead_StatusstringCurrent status of the lead data[].WebsitestringLead's website URL data[].CitystringLead's city data[].StatestringLead's state or province data[].CountrystringLead's country data[].DescriptionstringDescription or notes about the lead data[].Created_TimestringTime the record was created data[].Modified_TimestringTime the record was last modified
Returns a paginated list of contacts
Python SDK
await zoho_crm . contacts . list ( )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "contacts", "action": "list" }'
Parameters
Parameter Name Type Required Description pageintegerNo Page number per_pageintegerNo Number of records per page page_tokenstringNo Page token for fetching beyond 2000 records sort_bystringNo Field to sort by sort_order"asc" | "desc"No Sort order
Response Schema Records Field Name Type Description idstringOwnerobject | anyFirst_Namenull | stringLast_Namenull | stringFull_Namenull | stringEmailnull | stringPhonenull | stringMobilenull | stringFaxnull | stringTitlenull | stringDepartmentnull | stringAccount_Nameobject | anyLead_Sourcenull | stringDate_of_Birthnull | stringMailing_Streetnull | stringMailing_Citynull | stringMailing_Statenull | stringMailing_Zipnull | stringMailing_Countrynull | stringOther_Streetnull | stringOther_Citynull | stringOther_Statenull | stringOther_Zipnull | stringOther_Countrynull | stringDescriptionnull | stringCreated_Timenull | stringModified_Timenull | stringCreated_Byobject | anyModified_Byobject | anyRecord_Status__snull | string
Field Name Type Description more_recordsbooleanpageinteger
Creates a new contact record in Zoho CRM
Python SDK
await zoho_crm . contacts . create ( data = [ ] )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "contacts", "action": "create", "params": { "data": [] } }'
Parameters
Parameter Name Type Required Description dataarray<object>Yes Array containing the contact record to create data.First_NamestringNo Contact's first name data.Last_NamestringYes Contact's last name (required) data.EmailstringNo Contact's email address data.PhonestringNo Contact's phone number data.MobilestringNo Contact's mobile number data.TitlestringNo Contact's job title data.DepartmentstringNo Department the contact belongs to data.Lead_SourcestringNo Source from which the contact was generated data.Date_of_BirthstringNo Contact's date of birth (YYYY-MM-DD) data.Mailing_StreetstringNo Mailing street address data.Mailing_CitystringNo Mailing city data.Mailing_StatestringNo Mailing state or province data.Mailing_ZipstringNo Mailing ZIP/postal code data.Mailing_CountrystringNo Mailing country data.DescriptionstringNo Description or notes about the contact
Response Schema Records Field Name Type Description dataarray<object>data[].codestringdata[].detailsobjectdata[].details.Modified_Timenull | stringdata[].details.Modified_Byobject | anydata[].details.Created_Timenull | stringdata[].details.idstringdata[].details.Created_Byobject | anydata[].messagestringdata[].statusstring
Get a single contact by ID
Python SDK
await zoho_crm . contacts . get ( id = "<str>" )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "contacts", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes Contact ID
Updates an existing contact record in Zoho CRM
Python SDK
await zoho_crm . contacts . update ( data = [ ] , id = "<str>" )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "contacts", "action": "update", "params": { "data": [], "id": "<str>" } }'
Parameters
Parameter Name Type Required Description dataarray<object>Yes Array containing the contact fields to update data.First_NamestringNo Contact's first name data.Last_NamestringNo Contact's last name data.EmailstringNo Contact's email address data.PhonestringNo Contact's phone number data.MobilestringNo Contact's mobile number data.TitlestringNo Contact's job title data.DepartmentstringNo Department the contact belongs to data.Lead_SourcestringNo Source from which the contact was generated data.Date_of_BirthstringNo Contact's date of birth (YYYY-MM-DD) data.Mailing_StreetstringNo Mailing street address data.Mailing_CitystringNo Mailing city data.Mailing_StatestringNo Mailing state or province data.Mailing_ZipstringNo Mailing ZIP/postal code data.Mailing_CountrystringNo Mailing country data.DescriptionstringNo Description or notes about the contact idstringYes Contact ID
Response Schema Records Field Name Type Description dataarray<object>data[].codestringdata[].detailsobjectdata[].details.Modified_Timenull | stringdata[].details.Modified_Byobject | anydata[].details.Created_Timenull | stringdata[].details.idstringdata[].details.Created_Byobject | anydata[].messagestringdata[].statusstring
Contacts Context Store Search
Search and filter contacts records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await zoho_crm . contacts . context_store_search ( query = { "filter" : { "eq" : { "id" : "<str>" } } } )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "contacts", "action": "context_store_search", "params": { "query": {"filter": {"eq": {"id": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idstringUnique record identifier First_NamestringContact's first name Last_NamestringContact's last name Full_NamestringContact's full name EmailstringContact's email address PhonestringContact's phone number MobilestringContact's mobile number TitlestringContact's job title DepartmentstringDepartment the contact belongs to Lead_SourcestringSource from which the contact was generated Date_of_BirthstringContact's date of birth Mailing_CitystringMailing address city Mailing_StatestringMailing address state or province Mailing_CountrystringMailing address country DescriptionstringDescription or notes about the contact Created_TimestringTime the record was created Modified_TimestringTime the record was last modified
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idstringUnique record identifier data[].First_NamestringContact's first name data[].Last_NamestringContact's last name data[].Full_NamestringContact's full name data[].EmailstringContact's email address data[].PhonestringContact's phone number data[].MobilestringContact's mobile number data[].TitlestringContact's job title data[].DepartmentstringDepartment the contact belongs to data[].Lead_SourcestringSource from which the contact was generated data[].Date_of_BirthstringContact's date of birth data[].Mailing_CitystringMailing address city data[].Mailing_StatestringMailing address state or province data[].Mailing_CountrystringMailing address country data[].DescriptionstringDescription or notes about the contact data[].Created_TimestringTime the record was created data[].Modified_TimestringTime the record was last modified
Accounts
Accounts List
Returns a paginated list of accounts
Python SDK
await zoho_crm . accounts . list ( )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "accounts", "action": "list" }'
Parameters
Parameter Name Type Required Description pageintegerNo Page number per_pageintegerNo Number of records per page page_tokenstringNo Page token for fetching beyond 2000 records sort_bystringNo Field to sort by sort_order"asc" | "desc"No Sort order
Response Schema Records Field Name Type Description idstringOwnerobject | anyAccount_Namenull | stringAccount_Numbernull | stringAccount_Typenull | stringIndustrynull | stringAnnual_Revenuenull | numberEmployeesnull | integerPhonenull | stringFaxnull | stringWebsitenull | stringOwnershipnull | stringRatingnull | stringSIC_Codenull | integerTicker_Symbolnull | stringParent_Accountobject | anyBilling_Streetnull | stringBilling_Citynull | stringBilling_Statenull | stringBilling_Codenull | stringBilling_Countrynull | stringShipping_Streetnull | stringShipping_Citynull | stringShipping_Statenull | stringShipping_Codenull | stringShipping_Countrynull | stringDescriptionnull | stringCreated_Timenull | stringModified_Timenull | stringCreated_Byobject | anyModified_Byobject | anyRecord_Status__snull | string
Field Name Type Description more_recordsbooleanpageinteger
Accounts Create
Creates a new account record in Zoho CRM
Python SDK
await zoho_crm . accounts . create ( data = [ ] )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "accounts", "action": "create", "params": { "data": [] } }'
Parameters
Parameter Name Type Required Description dataarray<object>Yes Array containing the account record to create data.Account_NamestringYes Account/company name (required) data.Account_NumberstringNo Account number data.Account_TypestringNo Type of account (e.g., Analyst, Competitor, Customer) data.IndustrystringNo Industry the account belongs to data.Annual_RevenuenumberNo Annual revenue of the account data.EmployeesintegerNo Number of employees data.PhonestringNo Account phone number data.WebsitestringNo Account website URL data.OwnershipstringNo Ownership type (e.g., Public, Private) data.RatingstringNo Account rating data.Billing_StreetstringNo Billing street address data.Billing_CitystringNo Billing city data.Billing_StatestringNo Billing state or province data.Billing_CodestringNo Billing ZIP/postal code data.Billing_CountrystringNo Billing country data.Shipping_StreetstringNo Shipping street address data.Shipping_CitystringNo Shipping city data.Shipping_StatestringNo Shipping state or province data.Shipping_CodestringNo Shipping ZIP/postal code data.Shipping_CountrystringNo Shipping country data.DescriptionstringNo Description or notes about the account
Response Schema Records Field Name Type Description dataarray<object>data[].codestringdata[].detailsobjectdata[].details.Modified_Timenull | stringdata[].details.Modified_Byobject | anydata[].details.Created_Timenull | stringdata[].details.idstringdata[].details.Created_Byobject | anydata[].messagestringdata[].statusstring
Accounts Get
Get a single account by ID
Python SDK
await zoho_crm . accounts . get ( id = "<str>" )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "accounts", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes Account ID
Accounts Update
Updates an existing account record in Zoho CRM
Python SDK
await zoho_crm . accounts . update ( data = [ ] , id = "<str>" )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "accounts", "action": "update", "params": { "data": [], "id": "<str>" } }'
Parameters
Parameter Name Type Required Description dataarray<object>Yes Array containing the account fields to update data.Account_NamestringNo Account/company name data.Account_NumberstringNo Account number data.Account_TypestringNo Type of account (e.g., Analyst, Competitor, Customer) data.IndustrystringNo Industry the account belongs to data.Annual_RevenuenumberNo Annual revenue of the account data.EmployeesintegerNo Number of employees data.PhonestringNo Account phone number data.WebsitestringNo Account website URL data.OwnershipstringNo Ownership type (e.g., Public, Private) data.RatingstringNo Account rating data.Billing_StreetstringNo Billing street address data.Billing_CitystringNo Billing city data.Billing_StatestringNo Billing state or province data.Billing_CodestringNo Billing ZIP/postal code data.Billing_CountrystringNo Billing country data.Shipping_StreetstringNo Shipping street address data.Shipping_CitystringNo Shipping city data.Shipping_StatestringNo Shipping state or province data.Shipping_CodestringNo Shipping ZIP/postal code data.Shipping_CountrystringNo Shipping country data.DescriptionstringNo Description or notes about the account idstringYes Account ID
Response Schema Records Field Name Type Description dataarray<object>data[].codestringdata[].detailsobjectdata[].details.Modified_Timenull | stringdata[].details.Modified_Byobject | anydata[].details.Created_Timenull | stringdata[].details.idstringdata[].details.Created_Byobject | anydata[].messagestringdata[].statusstring
Accounts Context Store Search
Search and filter accounts records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await zoho_crm . accounts . context_store_search ( query = { "filter" : { "eq" : { "id" : "<str>" } } } )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "accounts", "action": "context_store_search", "params": { "query": {"filter": {"eq": {"id": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idstringUnique record identifier Account_NamestringName of the account or company Account_NumberstringAccount number Account_TypestringType of account (e.g., Analyst, Competitor, Customer) IndustrystringIndustry the account belongs to Annual_RevenuenumberAnnual revenue of the account EmployeesintegerNumber of employees PhonestringAccount phone number WebsitestringAccount website URL OwnershipstringOwnership type (e.g., Public, Private) RatingstringAccount rating Billing_CitystringBilling address city Billing_StatestringBilling address state or province Billing_CountrystringBilling address country DescriptionstringDescription or notes about the account Created_TimestringTime the record was created Modified_TimestringTime the record was last modified
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idstringUnique record identifier data[].Account_NamestringName of the account or company data[].Account_NumberstringAccount number data[].Account_TypestringType of account (e.g., Analyst, Competitor, Customer) data[].IndustrystringIndustry the account belongs to data[].Annual_RevenuenumberAnnual revenue of the account data[].EmployeesintegerNumber of employees data[].PhonestringAccount phone number data[].WebsitestringAccount website URL data[].OwnershipstringOwnership type (e.g., Public, Private) data[].RatingstringAccount rating data[].Billing_CitystringBilling address city data[].Billing_StatestringBilling address state or province data[].Billing_CountrystringBilling address country data[].DescriptionstringDescription or notes about the account data[].Created_TimestringTime the record was created data[].Modified_TimestringTime the record was last modified
Deals
Deals List
Returns a paginated list of deals
Python SDK
await zoho_crm . deals . list ( )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "deals", "action": "list" }'
Parameters
Parameter Name Type Required Description pageintegerNo Page number per_pageintegerNo Number of records per page page_tokenstringNo Page token for fetching beyond 2000 records sort_bystringNo Field to sort by sort_order"asc" | "desc"No Sort order
Response Schema Records Field Name Type Description idstringOwnerobject | anyDeal_Namenull | stringAmountnull | numberStagenull | stringProbabilitynull | integerClosing_Datenull | stringTypenull | stringNext_Stepnull | stringLead_Sourcenull | stringContact_Nameobject | anyAccount_Nameobject | anyCampaign_Sourceobject | anyPipelinenull | objectDescriptionnull | stringCreated_Timenull | stringModified_Timenull | stringCreated_Byobject | anyModified_Byobject | anyRecord_Status__snull | string
Field Name Type Description more_recordsbooleanpageinteger
Deals Create
Creates a new deal record in Zoho CRM
Python SDK
await zoho_crm . deals . create ( data = [ ] )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "deals", "action": "create", "params": { "data": [] } }'
Parameters
Parameter Name Type Required Description dataarray<object>Yes Array containing the deal record to create data.Deal_NamestringYes Deal name (required) data.AmountnumberNo Monetary value of the deal data.StagestringYes Current stage of the deal in the pipeline (required) data.ProbabilityintegerNo Probability of closing the deal (percentage) data.Closing_DatestringYes Expected closing date (YYYY-MM-DD) data.TypestringNo Type of deal (e.g., New Business, Existing Business) data.Next_StepstringNo Next step in the deal process data.Lead_SourcestringNo Source from which the deal originated data.DescriptionstringNo Description or notes about the deal
Response Schema Records Field Name Type Description dataarray<object>data[].codestringdata[].detailsobjectdata[].details.Modified_Timenull | stringdata[].details.Modified_Byobject | anydata[].details.Created_Timenull | stringdata[].details.idstringdata[].details.Created_Byobject | anydata[].messagestringdata[].statusstring
Deals Get
Get a single deal by ID
Python SDK
await zoho_crm . deals . get ( id = "<str>" )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "deals", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes Deal ID
Deals Update
Updates an existing deal record in Zoho CRM
Python SDK
await zoho_crm . deals . update ( data = [ ] , id = "<str>" )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "deals", "action": "update", "params": { "data": [], "id": "<str>" } }'
Parameters
Parameter Name Type Required Description dataarray<object>Yes Array containing the deal fields to update data.Deal_NamestringNo Deal name data.AmountnumberNo Monetary value of the deal data.StagestringNo Current stage of the deal in the pipeline data.ProbabilityintegerNo Probability of closing the deal (percentage) data.Closing_DatestringNo Expected closing date (YYYY-MM-DD) data.TypestringNo Type of deal (e.g., New Business, Existing Business) data.Next_StepstringNo Next step in the deal process data.Lead_SourcestringNo Source from which the deal originated data.DescriptionstringNo Description or notes about the deal idstringYes Deal ID
Response Schema Records Field Name Type Description dataarray<object>data[].codestringdata[].detailsobjectdata[].details.Modified_Timenull | stringdata[].details.Modified_Byobject | anydata[].details.Created_Timenull | stringdata[].details.idstringdata[].details.Created_Byobject | anydata[].messagestringdata[].statusstring
Deals Context Store Search
Search and filter deals records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await zoho_crm . deals . context_store_search ( query = { "filter" : { "eq" : { "id" : "<str>" } } } )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "deals", "action": "context_store_search", "params": { "query": {"filter": {"eq": {"id": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idstringUnique record identifier Deal_NamestringName of the deal AmountnumberMonetary value of the deal StagestringCurrent stage of the deal in the pipeline ProbabilityintegerProbability of closing the deal (percentage) Closing_DatestringExpected closing date TypestringType of deal (e.g., New Business, Existing Business) Next_StepstringNext step in the deal process Lead_SourcestringSource from which the deal originated DescriptionstringDescription or notes about the deal Created_TimestringTime the record was created Modified_TimestringTime the record was last modified
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idstringUnique record identifier data[].Deal_NamestringName of the deal data[].AmountnumberMonetary value of the deal data[].StagestringCurrent stage of the deal in the pipeline data[].ProbabilityintegerProbability of closing the deal (percentage) data[].Closing_DatestringExpected closing date data[].TypestringType of deal (e.g., New Business, Existing Business) data[].Next_StepstringNext step in the deal process data[].Lead_SourcestringSource from which the deal originated data[].DescriptionstringDescription or notes about the deal data[].Created_TimestringTime the record was created data[].Modified_TimestringTime the record was last modified
Campaigns
Campaigns List
Returns a paginated list of campaigns
Python SDK
await zoho_crm . campaigns . list ( )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "campaigns", "action": "list" }'
Parameters
Parameter Name Type Required Description pageintegerNo Page number per_pageintegerNo Number of records per page page_tokenstringNo Page token for fetching beyond 2000 records sort_bystringNo Field to sort by sort_order"asc" | "desc"No Sort order
Response Schema Records Field Name Type Description idstringOwnerobject | anyCampaign_Namenull | stringTypenull | stringStatusnull | stringStart_Datenull | stringEnd_Datenull | stringExpected_Revenuenull | numberBudgeted_Costnull | numberActual_Costnull | numberNum_sentnull | stringExpected_Responsenull | integerDescriptionnull | stringCreated_Timenull | stringModified_Timenull | stringCreated_Byobject | anyModified_Byobject | anyRecord_Status__snull | string
Field Name Type Description more_recordsbooleanpageinteger
Campaigns Get
Get a single campaign by ID
Python SDK
await zoho_crm . campaigns . get ( id = "<str>" )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "campaigns", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes Campaign ID
Campaigns Context Store Search
Search and filter campaigns records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await zoho_crm . campaigns . context_store_search ( query = { "filter" : { "eq" : { "id" : "<str>" } } } )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "campaigns", "action": "context_store_search", "params": { "query": {"filter": {"eq": {"id": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idstringUnique record identifier Campaign_NamestringName of the campaign TypestringType of campaign (e.g., Email, Webinar, Conference) StatusstringCurrent status of the campaign Start_DatestringCampaign start date End_DatestringCampaign end date Expected_RevenuenumberExpected revenue from the campaign Budgeted_CostnumberBudget allocated for the campaign Actual_CostnumberActual cost incurred Num_sentstringNumber of campaign messages sent Expected_ResponseintegerExpected response count DescriptionstringDescription or notes about the campaign Created_TimestringTime the record was created Modified_TimestringTime the record was last modified
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idstringUnique record identifier data[].Campaign_NamestringName of the campaign data[].TypestringType of campaign (e.g., Email, Webinar, Conference) data[].StatusstringCurrent status of the campaign data[].Start_DatestringCampaign start date data[].End_DatestringCampaign end date data[].Expected_RevenuenumberExpected revenue from the campaign data[].Budgeted_CostnumberBudget allocated for the campaign data[].Actual_CostnumberActual cost incurred data[].Num_sentstringNumber of campaign messages sent data[].Expected_ResponseintegerExpected response count data[].DescriptionstringDescription or notes about the campaign data[].Created_TimestringTime the record was created data[].Modified_TimestringTime the record was last modified
Tasks
Tasks List
Returns a paginated list of tasks
Python SDK
await zoho_crm . tasks . list ( )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "tasks", "action": "list" }'
Parameters
Parameter Name Type Required Description pageintegerNo Page number per_pageintegerNo Number of records per page page_tokenstringNo Page token for fetching beyond 2000 records sort_bystringNo Field to sort by sort_order"asc" | "desc"No Sort order
Response Schema Records Field Name Type Description idstringOwnerobject | anySubjectnull | stringDue_Datenull | stringStatusnull | stringPrioritynull | stringSend_Notification_Emailnull | booleanRemind_Atnull | objectWho_Idobject | anyWhat_Idobject | anyRecurring_Activitynull | objectDescriptionnull | stringCreated_Timenull | stringModified_Timenull | stringCreated_Byobject | anyModified_Byobject | anyRecord_Status__snull | stringClosed_Timenull | string
Field Name Type Description more_recordsbooleanpageinteger
Tasks Create
Creates a new task record in Zoho CRM
Python SDK
await zoho_crm . tasks . create ( data = [ ] )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "tasks", "action": "create", "params": { "data": [] } }'
Parameters
Parameter Name Type Required Description dataarray<object>Yes Array containing the task record to create data.SubjectstringYes Subject or title of the task (required) data.Due_DatestringNo Due date for the task (YYYY-MM-DD) data.StatusstringNo Task status (e.g., Not Started, In Progress, Completed) data.PrioritystringNo Priority level (e.g., High, Highest, Low, Lowest, Normal) data.Send_Notification_EmailbooleanNo Whether to send a notification email data.DescriptionstringNo Description or notes about the task
Response Schema Records Field Name Type Description dataarray<object>data[].codestringdata[].detailsobjectdata[].details.Modified_Timenull | stringdata[].details.Modified_Byobject | anydata[].details.Created_Timenull | stringdata[].details.idstringdata[].details.Created_Byobject | anydata[].messagestringdata[].statusstring
Tasks Get
Get a single task by ID
Python SDK
await zoho_crm . tasks . get ( id = "<str>" )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "tasks", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes Task ID
Tasks Update
Updates an existing task record in Zoho CRM
Python SDK
await zoho_crm . tasks . update ( data = [ ] , id = "<str>" )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "tasks", "action": "update", "params": { "data": [], "id": "<str>" } }'
Parameters
Parameter Name Type Required Description dataarray<object>Yes Array containing the task fields to update data.SubjectstringNo Subject or title of the task data.Due_DatestringNo Due date for the task (YYYY-MM-DD) data.StatusstringNo Task status (e.g., Not Started, In Progress, Completed) data.PrioritystringNo Priority level (e.g., High, Highest, Low, Lowest, Normal) data.Send_Notification_EmailbooleanNo Whether to send a notification email data.DescriptionstringNo Description or notes about the task idstringYes Task ID
Response Schema Records Field Name Type Description dataarray<object>data[].codestringdata[].detailsobjectdata[].details.Modified_Timenull | stringdata[].details.Modified_Byobject | anydata[].details.Created_Timenull | stringdata[].details.idstringdata[].details.Created_Byobject | anydata[].messagestringdata[].statusstring
Tasks Context Store Search
Search and filter tasks records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await zoho_crm . tasks . context_store_search ( query = { "filter" : { "eq" : { "id" : "<str>" } } } )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "tasks", "action": "context_store_search", "params": { "query": {"filter": {"eq": {"id": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idstringUnique record identifier SubjectstringSubject or title of the task Due_DatestringDue date for the task StatusstringCurrent status (e.g., Not Started, In Progress, Completed) PrioritystringPriority level (e.g., High, Highest, Low, Lowest, Normal) Send_Notification_EmailbooleanWhether to send a notification email DescriptionstringDescription or notes about the task Created_TimestringTime the record was created Modified_TimestringTime the record was last modified Closed_TimestringTime the task was closed
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idstringUnique record identifier data[].SubjectstringSubject or title of the task data[].Due_DatestringDue date for the task data[].StatusstringCurrent status (e.g., Not Started, In Progress, Completed) data[].PrioritystringPriority level (e.g., High, Highest, Low, Lowest, Normal) data[].Send_Notification_EmailbooleanWhether to send a notification email data[].DescriptionstringDescription or notes about the task data[].Created_TimestringTime the record was created data[].Modified_TimestringTime the record was last modified data[].Closed_TimestringTime the task was closed
Events
Events List
Returns a paginated list of events (meetings/calendar events)
Python SDK
await zoho_crm . events . list ( )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "events", "action": "list" }'
Parameters
Parameter Name Type Required Description pageintegerNo Page number per_pageintegerNo Number of records per page page_tokenstringNo Page token for fetching beyond 2000 records sort_bystringNo Field to sort by sort_order"asc" | "desc"No Sort order
Response Schema Records Field Name Type Description idstringOwnerobject | anyEvent_Titlenull | stringStart_DateTimenull | stringEnd_DateTimenull | stringAll_daynull | booleanLocationnull | stringParticipantsnull | arrayWho_Idobject | anyWhat_Idobject | anyRemind_Atnull | objectRecurring_Activitynull | objectDescriptionnull | stringCreated_Timenull | stringModified_Timenull | stringCreated_Byobject | anyModified_Byobject | anyRecord_Status__snull | string
Field Name Type Description more_recordsbooleanpageinteger
Events Get
Get a single event by ID
Python SDK
await zoho_crm . events . get ( id = "<str>" )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "events", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes Event ID
Events Context Store Search
Search and filter events records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await zoho_crm . events . context_store_search ( query = { "filter" : { "eq" : { "id" : "<str>" } } } )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "events", "action": "context_store_search", "params": { "query": {"filter": {"eq": {"id": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idstringUnique record identifier Event_TitlestringTitle of the event Start_DateTimestringEvent start date and time End_DateTimestringEvent end date and time All_daybooleanWhether this is an all-day event LocationstringEvent location DescriptionstringDescription or notes about the event Created_TimestringTime the record was created Modified_TimestringTime the record was last modified
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idstringUnique record identifier data[].Event_TitlestringTitle of the event data[].Start_DateTimestringEvent start date and time data[].End_DateTimestringEvent end date and time data[].All_daybooleanWhether this is an all-day event data[].LocationstringEvent location data[].DescriptionstringDescription or notes about the event data[].Created_TimestringTime the record was created data[].Modified_TimestringTime the record was last modified
Calls
Calls List
Returns a paginated list of calls
Python SDK
await zoho_crm . calls . list ( )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "calls", "action": "list" }'
Parameters
Parameter Name Type Required Description pageintegerNo Page number per_pageintegerNo Number of records per page page_tokenstringNo Page token for fetching beyond 2000 records sort_bystringNo Field to sort by sort_order"asc" | "desc"No Sort order
Response Schema Records Field Name Type Description idstringOwnerobject | anySubjectnull | stringCall_Typenull | stringCall_Start_Timenull | stringCall_Durationnull | stringCall_Duration_in_secondsnull | numberCall_Purposenull | stringCall_Resultnull | stringWho_Idobject | anyWhat_Idobject | anyDescriptionnull | stringCaller_IDnull | stringOutgoing_Call_Statusnull | stringCreated_Timenull | stringModified_Timenull | stringCreated_Byobject | anyModified_Byobject | anyRecord_Status__snull | string
Field Name Type Description more_recordsbooleanpageinteger
Calls Get
Get a single call by ID
Python SDK
await zoho_crm . calls . get ( id = "<str>" )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "calls", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes Call ID
Calls Context Store Search
Search and filter calls records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await zoho_crm . calls . context_store_search ( query = { "filter" : { "eq" : { "id" : "<str>" } } } )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "calls", "action": "context_store_search", "params": { "query": {"filter": {"eq": {"id": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idstringUnique record identifier SubjectstringSubject of the call Call_TypestringType of call (Inbound or Outbound) Call_Start_TimestringStart time of the call Call_DurationstringDuration of the call as a formatted string Call_Duration_in_secondsnumberDuration of the call in seconds Call_PurposestringPurpose of the call Call_ResultstringResult or outcome of the call Caller_IDstringCaller ID number Outgoing_Call_StatusstringStatus of outgoing calls DescriptionstringDescription or notes about the call Created_TimestringTime the record was created Modified_TimestringTime the record was last modified
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idstringUnique record identifier data[].SubjectstringSubject of the call data[].Call_TypestringType of call (Inbound or Outbound) data[].Call_Start_TimestringStart time of the call data[].Call_DurationstringDuration of the call as a formatted string data[].Call_Duration_in_secondsnumberDuration of the call in seconds data[].Call_PurposestringPurpose of the call data[].Call_ResultstringResult or outcome of the call data[].Caller_IDstringCaller ID number data[].Outgoing_Call_StatusstringStatus of outgoing calls data[].DescriptionstringDescription or notes about the call data[].Created_TimestringTime the record was created data[].Modified_TimestringTime the record was last modified
Products
Products List
Returns a paginated list of products
Python SDK
await zoho_crm . products . list ( )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "products", "action": "list" }'
Parameters
Parameter Name Type Required Description pageintegerNo Page number per_pageintegerNo Number of records per page page_tokenstringNo Page token for fetching beyond 2000 records sort_bystringNo Field to sort by sort_order"asc" | "desc"No Sort order
Response Schema Records Field Name Type Description idstringOwnerobject | anyProduct_Namenull | stringProduct_Codenull | stringProduct_Categorynull | stringProduct_Activenull | booleanUnit_Pricenull | numberCommission_Ratenull | numberManufacturernull | stringSales_Start_Datenull | stringSales_End_Datenull | stringSupport_Start_Datenull | stringSupport_Expiry_Datenull | stringQty_in_Stocknull | numberQty_in_Demandnull | numberQty_Orderednull | numberReorder_Levelnull | numberHandlerobject | anyTaxnull | arrayVendor_Nameobject | anyDescriptionnull | stringCreated_Timenull | stringModified_Timenull | stringCreated_Byobject | anyModified_Byobject | anyRecord_Status__snull | string
Field Name Type Description more_recordsbooleanpageinteger
Products Get
Get a single product by ID
Python SDK
await zoho_crm . products . get ( id = "<str>" )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "products", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes Product ID
Products Context Store Search
Search and filter products records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await zoho_crm . products . context_store_search ( query = { "filter" : { "eq" : { "id" : "<str>" } } } )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "products", "action": "context_store_search", "params": { "query": {"filter": {"eq": {"id": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idstringUnique record identifier Product_NamestringName of the product Product_CodestringProduct code or SKU Product_CategorystringCategory of the product Product_ActivebooleanWhether the product is active Unit_PricenumberUnit price of the product Commission_RatenumberCommission rate for the product ManufacturerstringProduct manufacturer Sales_Start_DatestringDate when sales begin Sales_End_DatestringDate when sales end Qty_in_StocknumberQuantity currently in stock Qty_in_DemandnumberQuantity in demand Qty_OrderednumberQuantity on order DescriptionstringDescription of the product Created_TimestringTime the record was created Modified_TimestringTime the record was last modified
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idstringUnique record identifier data[].Product_NamestringName of the product data[].Product_CodestringProduct code or SKU data[].Product_CategorystringCategory of the product data[].Product_ActivebooleanWhether the product is active data[].Unit_PricenumberUnit price of the product data[].Commission_RatenumberCommission rate for the product data[].ManufacturerstringProduct manufacturer data[].Sales_Start_DatestringDate when sales begin data[].Sales_End_DatestringDate when sales end data[].Qty_in_StocknumberQuantity currently in stock data[].Qty_in_DemandnumberQuantity in demand data[].Qty_OrderednumberQuantity on order data[].DescriptionstringDescription of the product data[].Created_TimestringTime the record was created data[].Modified_TimestringTime the record was last modified
Quotes
Quotes List
Returns a paginated list of quotes
Python SDK
await zoho_crm . quotes . list ( )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "quotes", "action": "list" }'
Parameters
Parameter Name Type Required Description pageintegerNo Page number per_pageintegerNo Number of records per page page_tokenstringNo Page token for fetching beyond 2000 records sort_bystringNo Field to sort by sort_order"asc" | "desc"No Sort order
Response Schema Records Field Name Type Description idstringOwnerobject | anySubjectnull | stringQuote_Stagenull | stringValid_Tillnull | stringDeal_Nameobject | anyContact_Nameobject | anyAccount_Nameobject | anyCarriernull | stringShipping_Streetnull | stringShipping_Citynull | stringShipping_Statenull | stringShipping_Codenull | stringShipping_Countrynull | stringBilling_Streetnull | stringBilling_Citynull | stringBilling_Statenull | stringBilling_Codenull | stringBilling_Countrynull | stringSub_Totalnull | numberTaxnull | numberAdjustmentnull | numberGrand_Totalnull | numberDiscountnull | numberTerms_and_Conditionsnull | stringDescriptionnull | stringCreated_Timenull | stringModified_Timenull | stringCreated_Byobject | anyModified_Byobject | anyRecord_Status__snull | string
Field Name Type Description more_recordsbooleanpageinteger
Quotes Get
Get a single quote by ID
Python SDK
await zoho_crm . quotes . get ( id = "<str>" )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "quotes", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes Quote ID
Quotes Context Store Search
Search and filter quotes records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await zoho_crm . quotes . context_store_search ( query = { "filter" : { "eq" : { "id" : "<str>" } } } )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "quotes", "action": "context_store_search", "params": { "query": {"filter": {"eq": {"id": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idstringUnique record identifier SubjectstringSubject or title of the quote Quote_StagestringCurrent stage of the quote Valid_TillstringDate until which the quote is valid CarrierstringShipping carrier Sub_TotalnumberSubtotal before tax and adjustments TaxnumberTax amount AdjustmentnumberAdjustment amount Grand_TotalnumberTotal amount including tax and adjustments DiscountnumberDiscount amount Terms_and_ConditionsstringTerms and conditions text DescriptionstringDescription or notes about the quote Created_TimestringTime the record was created Modified_TimestringTime the record was last modified
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idstringUnique record identifier data[].SubjectstringSubject or title of the quote data[].Quote_StagestringCurrent stage of the quote data[].Valid_TillstringDate until which the quote is valid data[].CarrierstringShipping carrier data[].Sub_TotalnumberSubtotal before tax and adjustments data[].TaxnumberTax amount data[].AdjustmentnumberAdjustment amount data[].Grand_TotalnumberTotal amount including tax and adjustments data[].DiscountnumberDiscount amount data[].Terms_and_ConditionsstringTerms and conditions text data[].DescriptionstringDescription or notes about the quote data[].Created_TimestringTime the record was created data[].Modified_TimestringTime the record was last modified
Invoices
Invoices List
Returns a paginated list of invoices
Python SDK
await zoho_crm . invoices . list ( )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "invoices", "action": "list" }'
Parameters
Parameter Name Type Required Description pageintegerNo Page number per_pageintegerNo Number of records per page page_tokenstringNo Page token for fetching beyond 2000 records sort_bystringNo Field to sort by sort_order"asc" | "desc"No Sort order
Response Schema Records Field Name Type Description idstringOwnerobject | anySubjectnull | stringInvoice_Numbernull | stringInvoice_Datenull | stringDue_Datenull | stringStatusnull | stringSales_Orderobject | anyContact_Nameobject | anyAccount_Nameobject | anyDeal_Nameobject | anyPurchase_Ordernull | stringExcise_Dutynull | numberBilling_Streetnull | stringBilling_Citynull | stringBilling_Statenull | stringBilling_Codenull | stringBilling_Countrynull | stringShipping_Streetnull | stringShipping_Citynull | stringShipping_Statenull | stringShipping_Codenull | stringShipping_Countrynull | stringSub_Totalnull | numberTaxnull | numberAdjustmentnull | numberGrand_Totalnull | numberDiscountnull | numberTerms_and_Conditionsnull | stringDescriptionnull | stringCreated_Timenull | stringModified_Timenull | stringCreated_Byobject | anyModified_Byobject | anyRecord_Status__snull | string
Field Name Type Description more_recordsbooleanpageinteger
Invoices Get
Get a single invoice by ID
Python SDK
await zoho_crm . invoices . get ( id = "<str>" )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "invoices", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes Invoice ID
Invoices Context Store Search
Search and filter invoices records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await zoho_crm . invoices . context_store_search ( query = { "filter" : { "eq" : { "id" : "<str>" } } } )
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {your_auth_token}' \ --data '{ "entity": "invoices", "action": "context_store_search", "params": { "query": {"filter": {"eq": {"id": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idstringUnique record identifier SubjectstringSubject or title of the invoice Invoice_NumberstringInvoice number Invoice_DatestringDate the invoice was issued Due_DatestringPayment due date StatusstringCurrent status of the invoice Purchase_OrderstringAssociated purchase order number Sub_TotalnumberSubtotal before tax and adjustments TaxnumberTax amount AdjustmentnumberAdjustment amount Grand_TotalnumberTotal amount including tax and adjustments DiscountnumberDiscount amount Excise_DutynumberExcise duty amount Terms_and_ConditionsstringTerms and conditions text DescriptionstringDescription or notes about the invoice Created_TimestringTime the record was created Modified_TimestringTime the record was last modified
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idstringUnique record identifier data[].SubjectstringSubject or title of the invoice data[].Invoice_NumberstringInvoice number data[].Invoice_DatestringDate the invoice was issued data[].Due_DatestringPayment due date data[].StatusstringCurrent status of the invoice data[].Purchase_OrderstringAssociated purchase order number data[].Sub_TotalnumberSubtotal before tax and adjustments data[].TaxnumberTax amount data[].AdjustmentnumberAdjustment amount data[].Grand_TotalnumberTotal amount including tax and adjustments data[].DiscountnumberDiscount amount data[].Excise_DutynumberExcise duty amount data[].Terms_and_ConditionsstringTerms and conditions text data[].DescriptionstringDescription or notes about the invoice data[].Created_TimestringTime the record was created data[].Modified_TimestringTime the record was last modified