Zoho CRM

Zoho CRM Contacts API

The Contacts API from Zoho CRM — 4 operation(s) for contacts.

Documentation GitHub OpenAPI

Business capability

Customer Data Management BC-420.10

Operations 11

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /contacts/roles List contact roles · Get Contact Roles #

Ask an LLM

“What contact roles are defined in my CRM, like Decision Maker or Evaluator?”

“Can I see every contact role available to assign on deals?”

Tell an agent

List all contact roles.

Show the contact role definitions set up in the CRM.

POST /contacts/roles Create new contact roles · Create Contact Roles #

Ask an LLM

“How do I add a new contact role such as Technical Buyer?”

“Can I create several contact roles in one request?”

Tell an agent

Create contact roles {contact_roles}.

Add a new contact role definition named in {contact_roles}.

PUT /contacts/roles Update several contact roles · Update Contact Roles #

Ask an LLM

“Can I rename or reorder multiple contact roles at once?”

“Is there a bulk edit for contact role definitions?”

Tell an agent

Update these contact roles: {contact_roles}.

Bulk rename the contact roles as listed in {contact_roles}.

DELETE /contacts/roles Delete several contact roles · Delete Contact Roles #

Ask an LLM

“Can I delete multiple contact role definitions by their IDs?”

“What's the way to remove a batch of unused contact roles?”

Tell an agent destructive · confirm first

Delete contact roles {ids}.

Remove the contact role definitions with IDs {ids}.

GET /contacts/roles/{role} Get a contact role by ID · Get Role #

Ask an LLM

“Where do I look up one contact role definition by its ID?”

“What are the name and sequence of a specific contact role?”

Tell an agent

Get contact role {role}.

Show the details of contact role ID {role}.

PUT /contacts/roles/{role} Update a single contact role · Update Role #

Ask an LLM

“Can I rename just one contact role by its ID?”

“Is there a way to edit one contact role definition without a bulk update?”

Tell an agent

Update contact role {role} with {contact_roles}.

Rename contact role {role}.

DELETE /contacts/roles/{role} Delete a single contact role · Delete Role #

Ask an LLM

“How do I delete one contact role definition?”

“Can a specific contact role be removed by its ID?”

Tell an agent destructive · confirm first

Delete contact role {role}.

Remove the contact role definition {role}.

POST /Contacts/{contactId}/Emails/actions/link_record Link a contact's emails to deals · Link Emails to Deals #

Ask an LLM

“Can I link several emails from a contact to the related deals in the CRM?”

“How do I associate a contact's email conversations with a deal record?”

Tell an agent

Link emails {Emails} from contact {contactId} to their deals.

Attach contact {contactId}'s emails to the specified deals.

DELETE /Contacts/{contactId}/Emails/actions/link_record Unlink several emails from records · Unlink Emails from Records #

Ask an LLM

“Can I unlink multiple of a contact's emails from the records they're tied to?”

“Which message IDs and owner do I need to detach emails in bulk from deals?”

Tell an agent destructive · confirm first

Unlink emails {message_ids} owned by {owner_id} from contact {contactId}'s linked records.

Detach messages {message_ids} of contact {contactId} from their records for owner {owner_id}.

POST /Contacts/{contactId}/Emails/{messageId}/actions/link_record Link one email to a record · Link Email to Record #

Ask an LLM

“How do I link a single email message from a contact to a specific record?”

“Can I attach just one of a contact's emails to a deal?”

Tell an agent

Link email {messageId} of contact {contactId} to the record in {Emails}.

Associate message {messageId} from contact {contactId} with a deal.

DELETE /Contacts/{contactId}/Emails/{messageId}/actions/link_record Unlink one email from a record · Unlink Email from Record #

Ask an LLM

“Can I unlink one specific email message from the record it was linked to?”

“What's needed to detach a single contact email from a deal?”

Tell an agent destructive · confirm first

Unlink email {messageId} of contact {contactId} for owner {owner_id}.

Detach only message {messageId} from contact {contactId}'s linked record, owner {owner_id}.

Documentation

https://www.zoho.com/crm/developer/docs/api/v2/notifications/

https://www.zoho.com/crm/developer/docs/api/v8/

https://www.zoho.com/crm/developer/docs/api/v8/list-available-rest-apis.html

Specifications

https://artifacts.apis.io/zoho-crm/openapi/zoho-crm-contacts-api-openapi.yml

https://artifacts.apis.io/zoho-crm/asyncapi/zoho-crm-notifications-asyncapi.yml

Other Resources

https://artifacts.apis.io/zoho-crm/asyncapi/zoho-crm-notifications-asyncapi.yml

https://github.com/zoho/crm-oas/blob/main/v8.0/apis.json

https://github.com/zoho/crm-oas/blob/main/v8.0/appointment_preference.json

https://github.com/zoho/crm-oas/blob/main/v8.0/appointments.json

https://github.com/zoho/crm-oas/blob/main/v8.0/assignment_rules.json

https://github.com/zoho/crm-oas/blob/main/v8.0/associate_email.json

https://github.com/zoho/crm-oas/blob/main/v8.0/attachments.json

https://github.com/zoho/crm-oas/blob/main/v8.0/audit_log_export.json

https://github.com/zoho/crm-oas/blob/main/v8.0/available_currencies.json

https://github.com/zoho/crm-oas/blob/main/v8.0/bulk_read.json

https://github.com/zoho/crm-oas/blob/main/v8.0/bulk_write.json

https://github.com/zoho/crm-oas/blob/main/v8.0/business_hours.json

https://github.com/zoho/crm-oas/blob/main/v8.0/cadences_execution.json

https://github.com/zoho/crm-oas/blob/main/v8.0/cadences.json

https://github.com/zoho/crm-oas/blob/main/v8.0/call_preferences.json

https://github.com/zoho/crm-oas/blob/main/v8.0/cancel_meetings.json

https://github.com/zoho/crm-oas/blob/main/v8.0/change_owner.json

https://github.com/zoho/crm-oas/blob/main/v8.0/composite_requests.json

https://github.com/zoho/crm-oas/blob/main/v8.0/contact_roles.json

https://github.com/zoho/crm-oas/blob/main/v8.0/conversion_option.json

https://github.com/zoho/crm-oas/blob/main/v8.0/convert.json

https://github.com/zoho/crm-oas/blob/main/v8.0/coql.json

https://github.com/zoho/crm-oas/blob/main/v8.0/currencies.json

https://github.com/zoho/crm-oas/blob/main/v8.0/custom_views.json

https://github.com/zoho/crm-oas/blob/main/v8.0/data_sharing.json

https://github.com/zoho/crm-oas/blob/main/v8.0/deal_contact_roles.json

https://github.com/zoho/crm-oas/blob/main/v8.0/deal_link_emails.json

https://github.com/zoho/crm-oas/blob/main/v8.0/download_attachments.json

https://github.com/zoho/crm-oas/blob/main/v8.0/download_inline_images.json

https://github.com/zoho/crm-oas/blob/main/v8.0/duplicate_check_preference.json

https://github.com/zoho/crm-oas/blob/main/v8.0/email_drafts.json

https://github.com/zoho/crm-oas/blob/main/v8.0/email_templates.json

https://github.com/zoho/crm-oas/blob/main/v8.0/emails_sharing_details.json

https://github.com/zoho/crm-oas/blob/main/v8.0/features.json

https://github.com/zoho/crm-oas/blob/main/v8.0/fetch_full_data.json

https://github.com/zoho/crm-oas/blob/main/v8.0/field_updates.json

https://github.com/zoho/crm-oas/blob/main/v8.0/fields.json

https://github.com/zoho/crm-oas/blob/main/v8.0/files.json

https://github.com/zoho/crm-oas/blob/main/v8.0/find_and_merge.json

https://github.com/zoho/crm-oas/blob/main/v8.0/fiscal_year.json

https://github.com/zoho/crm-oas/blob/main/v8.0/from_addresses.json

https://github.com/zoho/crm-oas/blob/main/v8.0/get_related_records_count.json

https://github.com/zoho/crm-oas/blob/main/v8.0/global_picklists.json

https://github.com/zoho/crm-oas/blob/main/v8.0/holidays.json

https://github.com/zoho/crm-oas/blob/main/v8.0/inventory_convert.json

https://github.com/zoho/crm-oas/blob/main/v8.0/inventory_templates.json

https://github.com/zoho/crm-oas/blob/main/v8.0/layouts_activate_deactivate.json

https://github.com/zoho/crm-oas/blob/main/v8.0/layouts.json

https://github.com/zoho/crm-oas/blob/main/v8.0/locking_informations.json

https://github.com/zoho/crm-oas/blob/main/v8.0/mail_merge.json

https://github.com/zoho/crm-oas/blob/main/v8.0/map_dependency.json

https://github.com/zoho/crm-oas/blob/main/v8.0/mass_change_owner.json

https://github.com/zoho/crm-oas/blob/main/v8.0/mass_convert.json

https://github.com/zoho/crm-oas/blob/main/v8.0/mass_delete_cvid.json

https://github.com/zoho/crm-oas/blob/main/v8.0/mass_delete_tags.json

https://github.com/zoho/crm-oas/blob/main/v8.0/mass_update.json

https://github.com/zoho/crm-oas/blob/main/v8.0/module_search.json

https://github.com/zoho/crm-oas/blob/main/v8.0/modules.json

https://github.com/zoho/crm-oas/blob/main/v8.0/notes.json

https://github.com/zoho/crm-oas/blob/main/v8.0/notifications.json

https://github.com/zoho/crm-oas/blob/main/v8.0/org.json

https://github.com/zoho/crm-oas/blob/main/v8.0/org_photo.json

https://github.com/zoho/crm-oas/blob/main/v8.0/ownership_history.json

https://github.com/zoho/crm-oas/blob/main/v8.0/pick_list_values.json

https://github.com/zoho/crm-oas/blob/main/v8.0/pipeline.json

https://github.com/zoho/crm-oas/blob/main/v8.0/portal_user_type.json

https://github.com/zoho/crm-oas/blob/main/v8.0/portal_users.json

https://github.com/zoho/crm-oas/blob/main/v8.0/portals.json

https://github.com/zoho/crm-oas/blob/main/v8.0/profiles.json

https://github.com/zoho/crm-oas/blob/main/v8.0/record_count.json

https://github.com/zoho/crm-oas/blob/main/v8.0/record_locking_configurations.json

https://github.com/zoho/crm-oas/blob/main/v8.0/record.json

https://github.com/zoho/crm-oas/blob/main/v8.0/record_photo.json

https://github.com/zoho/crm-oas/blob/main/v8.0/record_share_email.json

https://github.com/zoho/crm-oas/blob/main/v8.0/recycle_bin.json

https://github.com/zoho/crm-oas/blob/main/v8.0/related_lists.json

https://github.com/zoho/crm-oas/blob/main/v8.0/related_notes.json

https://github.com/zoho/crm-oas/blob/main/v8.0/related_records.json

https://github.com/zoho/crm-oas/blob/main/v8.0/roles.json

https://github.com/zoho/crm-oas/blob/main/v8.0/scoring_rules.json

https://github.com/zoho/crm-oas/blob/main/v8.0/send_mail.json

https://github.com/zoho/crm-oas/blob/main/v8.0/service_preference.json

https://github.com/zoho/crm-oas/blob/main/v8.0/services.json

https://github.com/zoho/crm-oas/blob/main/v8.0/share_records.json

https://github.com/zoho/crm-oas/blob/main/v8.0/shift_hours.json

https://github.com/zoho/crm-oas/blob/main/v8.0/tags_actions.json

https://github.com/zoho/crm-oas/blob/main/v8.0/tags.json

https://github.com/zoho/crm-oas/blob/main/v8.0/territories.json

https://github.com/zoho/crm-oas/blob/main/v8.0/territory_users.json

https://github.com/zoho/crm-oas/blob/main/v8.0/timelines.json

https://github.com/zoho/crm-oas/blob/main/v8.0/unblock_email.json

https://github.com/zoho/crm-oas/blob/main/v8.0/unsubscribe_links.json

https://github.com/zoho/crm-oas/blob/main/v8.0/upload.json

https://github.com/zoho/crm-oas/blob/main/v8.0/user_groups.json

https://github.com/zoho/crm-oas/blob/main/v8.0/users.json

https://github.com/zoho/crm-oas/blob/main/v8.0/users_territories.json

https://github.com/zoho/crm-oas/blob/main/v8.0/users_transfer.json

https://github.com/zoho/crm-oas/blob/main/v8.0/variable_groups.json

https://github.com/zoho/crm-oas/blob/main/v8.0/variables.json

https://github.com/zoho/crm-oas/blob/main/v8.0/webhooks.json

https://github.com/zoho/crm-oas/blob/main/v8.0/wizards.json

https://github.com/zoho/crm-oas/blob/main/v8.0/workflow_configurations.json

https://github.com/zoho/crm-oas/blob/main/v8.0/workflow_rules.json

https://github.com/zoho/crm-oas/blob/main/v8.0/workflow_tasks.json

https://github.com/zoho/crm-oas/blob/main/v8.0/zia_enrichment.json

https://github.com/zoho/crm-oas/blob/main/v8.0/zia_org_enrichment.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/zoho-crm:zoho-crm-contacts-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Zoho Crm Contacts API
  version: '1.0'
  description: 'Operations tagged Contacts across 2 of this provider''s published API definitions: zoho-crm-contact-roles-openapi.json, zoho-crm-deal-link-emails-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://zohoapis.{dc}/crm/{version}
  description: API Server URL
  variables:
    dc:
      enum:
      - com
      - eu
      - in
      - cn
      - au
      default: com
      description: API Server URL TLD
    version:
      default: v8
      description: API Version
tags:


# --- truncated at 32 KB (104 KB total) ---
# Full source: https://artifacts.apis.io/zoho-crm/openapi/zoho-crm-contacts-api-openapi.yml