NAiOS IconNAiOS Logo
Volver al catálogo

Zoho Bigin

zoho_bigin

Zoho Bigin is a simplified CRM solution from Zoho tailored for small businesses, focusing on pipeline tracking and relationship management

Acciones
12
Triggers
0
Autenticación
OAuth gestionado
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (12)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Add RecordsZOHO_BIGIN_ADD_RECORDSAcción

Tool to add new records to a module. use when you need to programmatically insert one or more records into bigin after confirming module name and field api names. provide required fields per module (e.g., contacts requires last name).

Parámetros de entrada

  • dataobject[]Obligatorio

    List of JSON objects to insert. Each object maps Field API names to values. Max 100 records per call.

  • triggerstring[]

    Array of workflow triggers. Default ['workflow'] executes workflows; use [] to skip workflows.

  • module_api_namestringObligatorioenum

    The API name of the module to insert into. Allowed: Contacts, Pipelines, Accounts, Products, Tasks, Events, Calls

    ContactsPipelinesAccountsProductsTasksEventsCalls

Parámetros de salida

  • dataobject[]Obligatorio

    Results for each record insert request

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Add Tags to RecordsZOHO_BIGIN_ADD_TAGS_TO_RECORDSAcción

Tool to add tags to a specific record in a module. use when you need to categorize or label a record after creation or update.

Parámetros de entrada

  • tagsobject[]Obligatorio

    List of tag objects to add to the record

  • record_idstringObligatorio

    Unique identifier of the record to which tags will be added

  • over_writeboolean

    Whether to overwrite existing tags (default: false)

  • module_api_namestringObligatorioenum

    API name of the module where record resides

    ContactsPipelinesCompaniesProductsTasksEventsCalls

Parámetros de salida

  • dataobject[]Obligatorio

    List of results for each record operation

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

  • wf_schedulerstringObligatorio

    Indicates if the workflow scheduler is enabled

  • success_countstringObligatorio

    Number of successful tag additions

Create TagsZOHO_BIGIN_CREATE_TAGSAcción

Tool to create tags for a module. use when you need to add new tags to a specific module in zoho bigin.

Parámetros de entrada

  • tagsobject[]Obligatorio

    List of tags to create

  • modulestringObligatorioenum

    API name of the module where tags will be added

    ContactsPipelinesAccountsProductsTasksEventsCalls

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete AttachmentZOHO_BIGIN_DELETE_ATTACHMENTAcción

Tool to delete an attachment from a record. use when you need to remove a file after confirming its record id and attachment id.

Parámetros de entrada

  • record_idstringObligatorio

    Unique ID of the record from which to delete the attachment.

  • attachment_idstringObligatorio

    Unique ID of the attachment to be deleted.

  • module_api_namestringObligatorioenum

    API name of the module. Must be one of: Contacts, Pipelines, Accounts, Products, Tasks, Events, Notes.

    ContactsPipelinesAccountsProductsTasksEventsNotes

Parámetros de salida

  • dataobject[]Obligatorio

    List containing the result of the delete operation.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete RecordsZOHO_BIGIN_DELETE_RECORDSAcción

Tool to delete records from a module. use when removing one or multiple records after confirming their ids.

Parámetros de entrada

  • idsstring[]Obligatorio

    List of record IDs to delete

  • wf_triggerboolean

    Whether to trigger workflow rules upon deletion

  • module_api_namestringObligatorioenum

    API name of the module to delete records from

    ContactsPipelinesAccountsProductsTasksEventsCalls

Parámetros de salida

  • dataobject[]Obligatorio

    Results of each delete operation

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Download AttachmentZOHO_BIGIN_DOWNLOAD_ATTACHMENTAcción

Tool to download an attachment from a record. use when you need the binary content of a specific attachment after confirming the record and attachment ids.

Parámetros de entrada

  • record_idstringObligatorio

    The unique identifier of the record from which to download the attachment.

  • attachment_idstringObligatorio

    The unique identifier of the attachment to download.

  • module_api_namestringObligatorioenum

    The API name of the module containing the record. One of: Contacts, Pipelines, Accounts, Products, Tasks, Events, Notes.

    ContactsPipelinesAccountsProductsTasksEventsNotes

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get AttachmentsZOHO_BIGIN_GET_ATTACHMENTSAcción

Tool to retrieve attachments for a record. use when you need a paginated list of attachments for a given module record.

Parámetros de entrada

  • pageinteger

    Page number for pagination, must be >=1. Default is 1.

  • fieldsstringObligatorio

    Comma-separated field API names to include in response. Up to 50 fields (e.g., File_Name,$file_id,Size,Parent_Id).

  • per_pageinteger

    Records per page, must be >=1. Default is 200.

  • record_idstringObligatorio

    Unique identifier of the record.

  • module_api_namestringObligatorioenum

    API name of the module.

    ContactsPipelinesAccountsProductsTasksEventsNotes

Parámetros de salida

  • dataobject[]Obligatorio

    List of attachment objects.

  • infoobjectObligatorio

    Pagination metadata.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Deleted RecordsZOHO_BIGIN_GET_DELETED_RECORDSAcción

Tool to get a list of deleted records in a module. use when auditing or restoring recently deleted data (recycle within 60 days, permanent within 120 days).

Parámetros de entrada

  • pageinteger

    Page number for pagination (starts at 1).

  • typestringenum

    Type of deleted records to retrieve: all (default), recycle (in bin ≤60 days), permanent (deleted ≤120 days).

    allrecyclepermanent
  • per_pageinteger

    Number of records per page (max 200).

  • module_api_namestringObligatorioenum

    API name of the module to retrieve deleted records from.

    ContactsPipelinesAccountsProductsTasksEventsCalls

Parámetros de salida

  • dataobject[]Obligatorio

    List of deleted records matching the query.

  • infoobjectObligatorio

    Pagination metadata for this response.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get ModulesZOHO_BIGIN_GET_MODULESAcción

Tool to retrieve a list of all modules. use when you need to discover which modules are available in bigin.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get RecordsZOHO_BIGIN_GET_RECORDSAcción

Tool to retrieve records from a bigin module. use when listing or querying module data with specific fields, sorting, filtering, and pagination.

Parámetros de entrada

  • cvidstring

    Custom view ID to filter by a saved custom view.

  • pageinteger

    Page index for pagination. Defaults to 1.

  • fieldsstringObligatorio

    Comma-separated list of up to 50 field API names to retrieve.

  • sort_bystring

    Field API name to sort by.

  • approvedstringenum

    Filter by approval status: 'true', 'false', or 'both'.

    truefalseboth
  • per_pageinteger

    Number of records per page. Defaults to 200, max 200.

  • page_tokenstring

    Token from previous response for beyond-2000 retrieval.

  • sort_orderstringenum

    Sort order: 'asc' or 'desc'. Applies when sort_by is provided.

    ascdesc
  • module_api_namestringObligatorioenum

    API name of the Bigin module to retrieve records from.

    ContactsPipelinesAccountsProductsTasksEventsCalls

Parámetros de salida

  • dataobject[]Obligatorio

    List of retrieved records.

  • infoobjectObligatorio

    Pagination and metadata information.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update RecordsZOHO_BIGIN_UPDATE_RECORDSAcción

Tool to update existing records in a module. use when you need to modify one or multiple records after confirming their ids and field api names. supports up to 100 records per call; specify an optional trigger to control workflow execution.

Parámetros de entrada

  • dataobject[]Obligatorio

    List of JSON objects to update. Each object must include 'id' and the fields to modify. Max 100 records per call.

  • triggerstring[]

    Array of workflow triggers. Default executes workflows; provide [] to skip workflow execution.

  • record_idstring

    Optional ID of a single record to update. If omitted, all IDs in `data` will be updated in bulk.

  • module_api_namestringObligatorioenum

    API name of the module to update records in. Allowed: Contacts, Pipelines, Accounts, Products, Tasks, Events, Calls

    ContactsPipelinesAccountsProductsTasksEventsCalls

Parámetros de salida

  • dataobject[]Obligatorio

    Results for each record update request

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Upload AttachmentZOHO_BIGIN_UPLOAD_ATTACHMENTAcción

Tool to upload an attachment to a record. use when you need to attach a file or specify a public url for upload to a bigin record. ensure module api name and record id are correct before calling.

Parámetros de entrada

  • filestring

    Local filesystem path of the file to upload. Provide either this or attachment_url.

  • record_idstringObligatorio

    Unique identifier of the record.

  • attachment_urlstring

    Public URL of the attachment to upload. Provide either this or file.

  • module_api_namestringObligatorioenum

    API name of the module to which the attachment should be added.

    ContactsPipelinesAccountsProductsTasksEventsNotes

Parámetros de salida

  • dataobject[]Obligatorio

    List containing the upload results.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not