AgencyZoom is for the P&C insurance agent that's looking to increase sales, boost retention and analyze agency & producer performance.
AgencyZoom is for the P&C insurance agent that's looking to increase sales, boost retention and analyze agency & producer performance. On Nagent, AgencyZoom is exposed as a fully-configurable crm integration that any agent can call — 99 actions, and API_KEY, BASIC_WITH_JWT authentication. No code is required to wire AgencyZoom into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use AgencyZoom to automate the kinds of tasks crm teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire AgencyZoom into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against AgencyZoom, with input parameters and output schema. Drop these into any step of an agent built in Helix.
AGENCYZOOM_AUTHENTICATE_FOR_JWTVIA_V4_SSOCompletes AgencyZoom V4 Single Sign-On (SSO) authentication by exchanging an OAuth2 authorization code for a JWT token. Prerequisites: First call get_auth_url_for_v4sso to obtain the authentication URL, then redirect the user to that URL for login. After successful authentication through Vertafore's OAuth provider, the callback will include a 'code' parameter. Use that code with this action to obtain the JWT token for API access. Note: This is typically used during initial authentication setup. The code is single-use, time-limited, and must match the PKCE challenge from the original auth request.
Input parameters
OAuth2 authorization code received from the V4SSO callback after user authentication through Vertafore login. This code is obtained by redirecting the user to the auth URL from GET /v1/api/v4sso/get-auth-params, where they authenticate, and the OAuth provider redirects back with this code parameter. The code is single-use and time-limited.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_BATCH_CREATE_CONTACTCreates 1 to 5 new contacts in AgencyZoom in a single batch API call.
Input parameters
A list of contact data objects, each defining a new contact to be created. Up to 5 contacts can be included in a single request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_BATCH_CREATE_LEADCreates up to 5 new leads in AgencyZoom; all referenced entity IDs (e.g., pipeline, user, custom field names) must exist, and organization `name` is required if `isBusiness` is true.
Input parameters
List of lead data objects. A maximum of 5 leads can be created per request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_BATCH_DELETE_TASKDeletes multiple AgencyZoom tasks in a batch; task deletion is permanent and the response indicates overall batch success, not individual task status.
Input parameters
List of unique numerical identifiers for the tasks to be deleted. Must provide at least one task ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_CHANGE_STATUS_FOR_LEADUpdates a lead's lifecycle status (e.g., Active, Won, Lost, X-Dated) and can optionally manage its workflow, pipeline, stage, source, or associated tags.
Input parameters
Date for the status change. If status is 5 (XDATED), this is the reactivation date (e.g., 'YYYY-MM-DD'); otherwise, it can be contact or quoted date.
Unique identifier of the lead to be updated (path parameter).
New status for the lead: 0 (ACTIVE), 2 (WON), 3 (LOST), 5 (XDATED).
List of tag IDs to associate with the lead.
ID of a specific workflow stage for direct assignment, irrespective of recycling.
Type or reason for the X-date, used if status is 5 (XDATED) (e.g., a predefined X-date recycle event name).
Identifier of the workflow to associate; if provided, the lead moves to this workflow.
Identifier for the loss reason. Recommended if status is 3 (LOST).
ID of the stage to move the lead to if it is being recycled.
Identifier of the stage within the specified workflow to move the lead to.
ID of the pipeline to move the lead to if it is being recycled.
Identifier for a new lead source to assign, updating the lead's origin.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_COMPLETE_TASKMarks an existing and accessible task in AgencyZoom as 'completed'; this action does not return the full updated task object.
Input parameters
Unique identifier of the task to be marked as completed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_CREATE_A_CUSTOMER_NOTEAdds a new note to an existing customer's profile using their ID; cannot be used to edit or retrieve existing notes.
Input parameters
The textual content of the note to be added to the customer's profile.
The unique identifier of the customer to whom the note will be added.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_CREATE_A_DRIVER_FOR_AN_OPPORTUNITYCreates a new driver record associated with an existing AgencyZoom opportunity using its ID; requires firstName and lastName, with optional fields for additional driver details.
Input parameters
Gender of the driver. Valid values are: "M" (Male), "F" (Female), "U" (Unknown), "X" (Non-Binary).
The date of birth of the driver. Must be in MM/DD/YYYY format.
The last name of the driver.
The first name of the driver.
The middle name of the driver.
Relationship status of the driver. Valid values are: "IN" (Named Insured), "SP" (Spouse), "PA" (Parent), "CH" (Child), "OT" (Other).
The driver's license number.
Marital status of the driver, represented by an integer code. Valid codes are: 1 (Single), 2 (Married), 3 (Widowed), 4 (Separated), 5 (Divorced), 6 (Domestic Partner), 7 (Civil Union), 8 (Fiancé / Fiancée), 9 (Unknown), 10 (Other).
The unique identifier of the opportunity to which the new driver will be associated.
The state where the driver is licensed, using its two-letter abbreviation (e.g., NY for New York).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_CREATE_A_LEAD_NOTEAdds a new note to an existing lead in AgencyZoom, identified by `leadId`.
Input parameters
Textual content of the note to be created for the lead.
Unique identifier of the lead to associate the note with.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_CREATE_A_LEAD_OPPORTUNITYAdds a new sales opportunity to an existing lead in AgencyZoom, requiring a valid `leadId`, `carrierId`, `productLineId`, and that custom field names match existing definitions in AgencyZoom.
Input parameters
Number of items in this opportunity (e.g., number of vehicles for auto policy). Defaults to 1.
The unique identifier of the existing lead to which this opportunity will be added.
The estimated or actual premium amount for this opportunity.
The unique identifier of the insurance carrier associated with this opportunity.
Custom fields to associate with this opportunity. `fieldName` must match a pre-defined field. Date-type `fieldValue` must be 'MM/dd/YYYY'.
The unique identifier of the product line (e.g., Auto, Home, Life) for this opportunity.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_CREATE_A_LEAD_QUOTECreates a new insurance quote for an existing lead in AgencyZoom, using valid carrier and product line IDs, to track a proposal; this action does not bind policies or process payments.
Input parameters
Number of items or units covered (e.g., vehicles for an auto policy); meaning may vary by product line.
Unique identifier of the lead for this quote.
Total premium amount in the smallest currency unit (e.g., cents for USD: 125075 means $1250.75).
Unique identifier of the insurance carrier.
Optional list of custom fields and their values.
Unique identifier of the product line (e.g., Auto, Home).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_CREATE_AN_OPPORTUNITYCreates a new lead opportunity in AgencyZoom; this action cannot update existing opportunities.
Input parameters
The number of items related to this opportunity, such as number of policies or vehicles.
The premium amount for the opportunity.
Identifier for the insurance carrier associated with the opportunity.
The expiration date of the policy or opportunity, in MM/dd/YYYY format.
A list of custom field objects to associate with the opportunity. If a custom field's value is a date, it must be in MM/dd/YYYY format.
Identifier for the policy type (product line) of the opportunity.
The ZIP code for the property associated with the opportunity.
The city name for the property, e.g., Monticello.
The state code for the property, e.g., FL for Florida.
The country code for the property, e.g., USA.
Identifier for the lead associated with this opportunity.
Primary street address line for the property.
Secondary street address line for the property (e.g., apartment, suite, unit number).
Indicates if the lead's mailing address is used as the property location (1 for true, 0 for false). The API defaults to 1 (true) if not specified, using the lead's address for the opportunity's property.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_CREATE_A_VEHICLE_FOR_AN_OPPORTUNITYAdds a new vehicle record to a specified opportunity; `opportunityId` must refer to a valid, existing opportunity.
Input parameters
Vehicle Identification Number (VIN); typically 17 characters.
Manufacturer of the vehicle (e.g., Toyota, Ford).
Manufacturing year of the vehicle (e.g., 2023).
Model of the vehicle (e.g., Camry, Civic).
Ownership status. Defaults to 'Owned' if not provided.
Identifier of the opportunity to associate the vehicle with.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_CREATE_BIZ_LEADCreates or updates a business lead in AgencyZoom using detailed personal and company information, for B2B sales and marketing lead management.
Input parameters
'Doing Business As' name if the business operates under a name different from its legal name.
The fax number for the business.
The postal code or ZIP code of the business address.
The city where the business is located.
Federal Employer Identification Number (FEIN) or Federal Tax ID for the business.
The legal name of the business or company (required for business leads).
The unique identifier of the Customer Service Representative (CSR) assigned to the business lead.
The primary email address of the business or primary contact.
Additional notes or comments about the business lead.
The primary phone number of the business.
The state or province where the business is located (e.g., CA, TX, NY).
The X-date (e.g., policy expiration or renewal date) associated with the business lead, preferably in YYYY-MM-DD format.
The country where the business is located (e.g., US, CA).
The annual payroll amount for the business.
The unique identifier of the stage within the specified pipeline where the business lead will be placed.
The unique identifier (ID) of the producer or agent to whom the business lead is assigned.
The last name of the primary contact person for the business lead.
The date when the business lead was marked as sold, preferably in YYYY-MM-DD format.
A single string containing multiple tag names, separated by semicolons (;). These tags help categorize or segment the business lead.
The first name of the primary contact person for the business lead.
The group code associated with the business lead, if applicable.
A list of unique identifiers for other Customer Service Representatives (CSRs) also assigned to or associated with this business lead.
The date when a quote was provided to the business lead, preferably in YYYY-MM-DD format.
The middle name of the primary contact person.
The unique identifier of the sales pipeline to which the business lead will be added.
The date of the last contact with the business lead, preferably in YYYY-MM-DD format.
The agency location code associated with the business lead, if applicable.
A list of custom field objects, each specifying a field name and its value(s) for the business lead.
The unique identifier of the lead source (e.g., 'Website', 'Referral', 'Trade Show').
The annual revenue of the business.
The primary street address of the business.
The department code associated with the business lead, if applicable.
A list of unique identifiers for other producers or agents also assigned to or associated with this business lead.
An alternative or secondary email address for the business or contact.
An alternative or secondary phone number for the business.
The unique identifier of the assignment group responsible for the business lead.
The total number of employees working for the business.
The next important expiration date related to the business lead (e.g., current policy expiration), in MM/DD/YY format.
Additional street address information (e.g., suite, floor, or building number).
The year when the business was established or started operations.
The unique identifier of the business classification code. Use the search_business_classifications action to get available classifications.
The number of years of management experience for the business owner or primary contact.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_CREATE_LEADCreates a new lead or updates an existing one in AgencyZoom; ensure `pipelineId`, `stageId`, `leadSourceId`, and `assignTo` reference valid, existing entities.
Input parameters
The postal code or ZIP code of the lead's address.
The city of the lead's address.
The name of the organization or company, required if 'isBusiness' is True.
The unique identifier of the Customer Service Representative (CSR) assigned to the lead.
The primary email address of the lead.
Additional notes or comments about the lead.
The primary phone number of the lead.
The state or province of the lead's address (e.g., CA, TX, NY).
The X-date (e.g., policy expiration or renewal date) associated with the lead, preferably in YYYY-MM-DD format.
The country of the lead's address (e.g., US, CA).
The unique identifier of the stage within the specified pipeline where the lead will be placed.
The unique identifier (ID) of the producer or agent to whom the lead is assigned.
The lead's date of birth, in MM/DD/YY format.
The last name of the lead.
An informal name or nickname for the lead.
The date when the lead was marked as sold, preferably in YYYY-MM-DD format.
A single string containing multiple tag names, separated by semicolons (;). These tags help categorize or segment the lead.
The first name of the lead.
The group code associated with the lead, if applicable.
A list of unique identifiers for other Customer Service Representatives (CSRs) also assigned to or associated with this lead.
The date when a quote was provided to the lead, preferably in YYYY-MM-DD format.
Indicates whether the lead is a business entity (True) or an individual consumer (False).
The middle name of the lead.
The unique identifier of the sales pipeline to which the lead will be added.
The date of the last contact with the lead, preferably in YYYY-MM-DD format.
The agency location code associated with the lead, if applicable.
A list of custom field objects, each specifying a field name and its value(s) for the lead.
The unique identifier of the lead source (e.g., 'Website', 'Referral').
An integer code representing the lead's marital status. The specific mapping of integers to statuses (e.g., 1 for Single, 2 for Married) should be confirmed within your AgencyZoom system configuration or API documentation.
The primary street address of the lead.
The department code associated with the lead, if applicable.
A list of unique identifiers for other producers or agents also assigned to or associated with this lead.
An alternative or secondary email address for the lead.
An alternative or secondary phone number for the lead.
The unique identifier of the assignment group responsible for the lead.
The next important expiration date related to the lead (e.g., current policy expiration), in MM/DD/YY format.
Additional street address information (e.g., apartment, suite, or unit number).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_CREATE_TASKCreates a new task in AgencyZoom; ensure `assigneeId`, `customerId`, or `leadId` are valid existing entities if provided, and use `contactEmail`, `customerId`, or `leadId` to link the task to a contact.
Input parameters
Task type ('call', 'email', 'meeting', 'todo'); highly recommended.
Title or name of the task; highly recommended for identification.
Unique ID of an existing lead to link to this task; must be an existing lead if provided.
Additional notes, comments, or description for the task.
Expected task duration in minutes, typically for 'call' or 'meeting' types.
List of email addresses for invitees, typically for 'meeting' type tasks.
Unique ID of the AgencyZoom user to assign the task; must be an existing user if provided.
Unique ID of an existing customer to link to this task; must be an existing customer if provided.
Due date and time, preferably in ISO 8601 format (e.g., 'YYYY-MM-DDTHH:MM:SSZ').
Email of the customer/lead to associate with the task; used if `customerId` or `leadId` is not provided.
If `True`, the time in `dueDatetime` is specific; otherwise, task is due anytime on `dueDatetime`'s date.
Unique ID of the Life & Health Professional for this task, for specific insurance workflows.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_DELETE_A_CUSTOMERIrreversibly deletes a customer and all associated data in AgencyZoom using their `customerId`; useful for offboarding or data privacy compliance.
Input parameters
The unique numerical identifier of the customer record to be permanently deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_DELETE_A_CUSTOMER_FILEPermanently deletes a specific file, identified by `fileId`, associated with a customer, identified by `customerId`.
Input parameters
The unique identifier for the file to be deleted from the specified customer's record.
The unique identifier for the customer whose file is to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_DELETE_A_CUSTOMER_POLICYPermanently deletes a specific policy associated with a customer, for instance, if it's cancelled or inactive; this action is irreversible and requires caution.
Input parameters
The unique identifier of the policy to be deleted from the specified customer's account.
The unique identifier of the customer whose policy is to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_DELETE_A_DRIVERPermanently deletes an existing driver record (a person associated with an insurance opportunity) from AgencyZoom using its unique `driverId`; this action is irreversible.
Input parameters
The unique identifier of the driver record to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_DELETE_A_LEAD_FILEDeletes a specific file (identified by `fileId`) associated with an existing lead (identified by `leadId`); this operation is irreversible.
Input parameters
The unique identifier for the file that needs to be deleted from the specified lead.
The unique identifier for the lead whose file is to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_DELETE_A_LEAD_OPPORTUNITYPermanently deletes an existing opportunity (by `opportunityId`) associated with an existing lead (by `leadId`) when it's irrelevant, closed, or erroneous; the lead itself remains.
Input parameters
The unique identifier for the lead whose opportunity is to be deleted.
The unique identifier for the opportunity to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_DELETE_A_LEAD_QUOTEDeletes a specific quote from a lead, requiring that the lead and quote exist and are associated.
Input parameters
Unique identifier of the lead.
Unique identifier of the quote to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_DELETE_AN_OPPORTUNITYPermanently deletes a specific opportunity by its unique ID; this action is irreversible and requires a valid, existing `opportunityId`.
Input parameters
The unique identifier of the opportunity to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_DELETE_A_TASKPermanently and irreversibly deletes an existing task, identified by its `taskId`.
Input parameters
Unique identifier of the task to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_DELETE_A_VEHICLEPermanently deletes a vehicle record by its `vehicleId`, which must correspond to an existing vehicle in the AgencyZoom system.
Input parameters
Unique identifier of the vehicle to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_DELETE_MESSAGEDeletes a specific message from an email thread within AgencyZoom. Requires the message ID to identify which message to remove. Returns the updated thread information with the remaining messages after deletion.
Input parameters
The unique identifier of the message to be deleted from the email thread. This ID can be obtained from thread details (messageInfo.id field) or search results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_DELETE_THREADPermanently deletes a specific email thread from the AgencyZoom system, identified by its `threadId` (expected by the endpoint), provided the thread exists.
Input parameters
Unique identifier of the email thread to be permanently deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_A_LIST_OF_ASSIGN_GROUPSRetrieves all assign groups configured in AgencyZoom, used for categorizing or assigning items to specific teams or units.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_A_LIST_OF_CARRIERSRetrieves all insurance carriers from AgencyZoom, typically used for populating selection lists or synchronizing carrier data; does not return detailed policy or coverage information.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_A_LIST_OF_CSRSFetches all Customer Service Representatives (CSRs), including their ID and name, returning an empty list if none are configured.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_A_LIST_OF_CUSTOM_FIELDSRetrieves metadata for all configured custom field definitions, not the specific values entered for individual records.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_A_LIST_OF_DRIVERS_FOR_AN_OPPORTUNITYRetrieves a list of drivers (individuals), including their personal details, licensing information, and relationship status, associated with a specific, existing `opportunityId` in AgencyZoom.
Input parameters
Unique identifier of the opportunity.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_A_LIST_OF_EMPLOYEESRetrieves a complete list of all employees for the authenticated agency; returns an empty list if no employees are configured.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_A_LIST_OF_LEAD_SOURCE_CATEGORIESRetrieves a comprehensive list of all predefined lead source categories from AgencyZoom, used to classify lead origins.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_A_LIST_OF_LEAD_SOURCESFetches a list of all lead sources configured in AgencyZoom, including their ID, name, sales exclusion status, and category ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_A_LIST_OF_LIFE_PROFESSIONALSRetrieves a list of life insurance professionals, including only their contact and status information (excluding sales or customer data), from the AgencyZoom platform.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_A_LIST_OF_LOCATIONSRetrieves all agency locations or branches from AgencyZoom; filtering options are not available.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_A_LIST_OF_LOSS_REASONSRetrieves all predefined loss reasons (e.g., 'Lost to competitor', 'Premium too high') available in AgencyZoom. These reasons can be used when marking leads as lost or for reporting purposes. No parameters required - returns complete list.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_A_LIST_OF_PIPELINESRetrieves all pipelines and their stages from AgencyZoom to understand workflow structures; this is a read-only operation and does not return individual items (like leads or tasks) within these pipelines.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_A_LIST_OF_PRODUCERRetrieves a list of all producers from AgencyZoom, typically related to text thread functionalities.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_A_LIST_OF_PRODUCT_LINES_POLICY_TYPESFetches all product lines and policy types from AgencyZoom, each detailed with its ID, name, and product category ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_A_LIST_OF_RECYCLE_EVENTSRetrieves the available recycle event types and any existing X-Date information for a specified lead in AgencyZoom. Returns a list of recycle event categories that can be used to trigger follow-ups (e.g., 'X-Date', 'Accident Falls Off', 'Prior Insurance Fulfilled').
Input parameters
The unique identifier of the lead for which to retrieve recycle events.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_A_LIST_OF_VEHICLES_FOR_AN_OPPORTUNITYRetrieves all vehicles associated with an existing opportunity, using its unique opportunityId.
Input parameters
Unique identifier for the opportunity, used to retrieve its associated vehicles.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_AMS_POLICIES_FOR_A_CUSTOMERRetrieves a customer's synchronized Agency Management System (AMS) policy data (typically a single policy); requires an active AMS integration, may return empty/default values if data is missing.
Input parameters
Unique identifier for the customer whose AMS policy data is to be retrieved.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_AUTH_URL_FOR_V4_SSORetrieves a fresh authentication URL for AgencyZoom's V4 Single Sign-On (SSO) process; call before each SSO attempt as the URL may change and should not be cached.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_DEPARTMENTS_GROUPSFetches department and group information for an agency, optionally filtered by a specific `agencyNumber`, to analyze its organizational structure.
Input parameters
The unique identifier for the agency. If provided, fetches departments and groups for this specific agency.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_LEAD_FILESRetrieves metadata (id, title, MIME type, size, dates, creator info) for files attached to leads in AgencyZoom. Optionally filter by `leadId` to get files for a specific lead, or omit to retrieve files across all leads. Returns file metadata only, not the actual file content.
Input parameters
Optional unique identifier of the lead to retrieve files for. If omitted, may return files across all leads.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_LEAD_NOTESFetches the complete history of notes for a specific lead by `leadId` (which must exist), useful for reviewing context for communications or follow-ups; this is a read-only operation.
Input parameters
The unique identifier of the lead for whom notes are to be retrieved.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_LEAD_QUOTESRetrieves all insurance quotes (active and inactive) for a specific lead ID, useful for reviewing or tracking quote history.
Input parameters
The unique identifier for the lead whose quotes are to be retrieved.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_LEAD_TASKSRetrieves all tasks for a specific lead, identified by its `leadId`, to review its activity history or manage follow-ups.
Input parameters
The unique identifier for the lead whose tasks are to be retrieved.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_LIST_OF_END_STAGESFetches a list of all defined end stages, representing final steps in processes like lead conversion or policy closure.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_POLICIES_FOR_A_CUSTOMERRetrieves from AgencyZoom all insurance policies for an existing customer (identified by `customerId`), including policy details like type, carrier, premium, effective dates, and assigned agents. Excludes premium payment history or claims information.
Input parameters
Unique identifier for the customer.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_THE_CUSTOMER_DETAILSFetches comprehensive details for a specific customer, including personal information, policies, notes, tasks, files, and custom fields, using their unique customer ID.
Input parameters
Unique identifier of the customer to retrieve details for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_THE_CUSTOMER_TASKSFetches all tasks (read-only task data) for a customer by `customerId` to review their activities, follow-ups, and action items; the `customerId` must be valid.
Input parameters
Unique identifier for the customer whose tasks are to be retrieved.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_THE_DRIVER_DETAILSRetrieves detailed information for a specific, existing driver (by `driverId`) associated with an AgencyZoom opportunity.
Input parameters
The unique identifier of the driver whose details are to be retrieved.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_THE_LEAD_DETAILSRetrieves comprehensive details for a specific lead in AgencyZoom by its unique `leadId` (which must correspond to an existing lead), including contact information, status, associated opportunities, quotes/policies, custom fields, and interaction history.
Input parameters
Unique identifier for the lead whose details are to be retrieved.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_THE_OPPORTUNITIES_FOR_A_LEADRetrieves all sales opportunities and their details for a specified, existing `leadId` in AgencyZoom.
Input parameters
The unique identifier of the lead for which opportunities are to be fetched.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_THE_OPPORTUNITY_DETAILSFetches comprehensive details for an existing opportunity using its unique `opportunityId`.
Input parameters
The unique identifier for the opportunity to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_THE_TASK_DETAILSRetrieves comprehensive details for a specific task using its unique `taskId`, which must correspond to an existing task in AgencyZoom.
Input parameters
Unique identifier of the task to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_THE_VEHICLE_DETAILSRetrieves detailed information for a specific vehicle, often associated with an AgencyZoom opportunity, using its unique vehicleId.
Input parameters
Unique identifier for the vehicle, often linked to an opportunity within AgencyZoom.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_GET_THREAD_DETAILSSearches and retrieves detailed information for email threads in AgencyZoom; no explicit search criteria are passed in this request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_LINK_A_DRIVER_TO_OPPORTUNITYAssigns or reassigns an existing driver to an existing opportunity.
Input parameters
The unique identifier for the existing driver (e.g., sales agent, team member) who will be linked to the opportunity.
The unique identifier for the existing opportunity to which the driver will be linked.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_LINK_A_VEHICLE_TO_OPPORTUNITYLinks an existing vehicle to an existing sales opportunity in AgencyZoom using their respective IDs, typically for managing auto insurance policies or related services.
Input parameters
Identifier of the vehicle to be linked to the opportunity.
Identifier of the opportunity to which the vehicle will be linked.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_LIST_PRODUCT_CATEGORIESRetrieves a complete, unfiltered list of all product categories (ID and name) from AgencyZoom, useful for understanding product organization or populating UI elements.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_LOG_THE_USER_INAuthenticates an existing AgencyZoom user using their email (as username) and password to obtain a JWT for API access; this action does not support new user creation.
Input parameters
The user's account password. Must match the password associated with the provided email/username.
The user's email address used as the login username. Must be a valid email format for an existing AgencyZoom account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_LOG_THE_USER_OUTUse this action to log the current user out of AgencyZoom by invalidating their active session token.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_MARK_THREAD_AS_UNREAD_API_ENDPOINTMarks a text thread in AgencyZoom as read or unread using its `threadId`; this action does not modify message content and the specified `threadId` must refer to an existing thread.
Input parameters
The unique identifier of the text/SMS thread whose read/unread status is to be updated. This must be a valid thread ID from the AgencyZoom system.
Boolean flag to control the thread's read/unread status. Set to `true` to mark the thread as unread, or `false` to mark it as read.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_MOVE_LEAD_TO_SOLDMarks an existing lead as sold by its `leadId` and records product details; `productLineId`, `premium`, `effectiveDate`, and `soldDate` are operationally required for each sold product, despite schema flexibility.
Input parameters
Identifier of the lead to be marked as sold.
If true, lead remains open after products are marked sold (e.g., for other potential sales). Defaults to false.
List of products sold to the lead.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_REMOVE_TEXT_THREAD_ENDPOINTCall this action to permanently delete an SMS/text message thread in AgencyZoom; the target thread is identified by its `threadId`. Note: This operation is idempotent - deleting a non-existent thread will return success.
Input parameters
The unique identifier of the SMS/text message thread to be deleted. This can be obtained from the search_sms_threads action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_REOPEN_A_TASKReopens an existing AgencyZoom task that is currently 'completed' or 'closed', allowing it to be reactivated with optional comments.
Input parameters
The unique identifier of the task to be reopened.
Optional comments providing context or reasons for reopening the task.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_SEARCH_BUSINESS_CLASSIFICATIONSRetrieves a comprehensive list of all available business classifications from AgencyZoom, each including an ID, code, and description.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_SEARCH_CUSTOMERSSearches for customers in AgencyZoom using criteria like contact information, policy details, or custom fields, with options for filtering, sorting, and pagination.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_SEARCH_EMAIL_THREADSRetrieves a list of email thread metadata from AgencyZoom, suitable for an overview when no specific filtering, sorting, or pagination is needed, as results are subject to default server-side limits and ordering.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_SEARCH_LEADSRetrieves AgencyZoom leads, using filters, pagination, and sorting options sent in the POST body, as the request schema itself is empty.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_SEARCH_LEADS_COUNTRetrieves a summary of lead counts categorized by workflow stage from AgencyZoom; this action does not support filtering and returns aggregate counts rather than individual lead details.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_SEARCH_LIFE_AND_HEALTH_LEADSSearches for life and health insurance leads by providing filter criteria (matching AlrLead fields) in the request body; an empty request may retrieve all leads or a default set.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_SEARCH_SMS_THREADSSearches and retrieves SMS threads from AgencyZoom, with search parameters, filters, sorting, and pagination typically provided in the request body of this POST operation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_SEARCH_TASKSSearches and lists tasks, supporting pagination and accepting filter criteria in the POST request body despite an empty request schema.
Input parameters
Page number for pagination.
Field to sort by.
Filter by task type.
Sort order: 'asc' or 'desc'.
Filter by time period (e.g., 'today', 'week', 'month').
Filter by task status: 0 (Open), 1 (Done), 2 (Cancelled).
Filter tasks created/due on or before this date (YYYY-MM-DD).
Filter by location code or name.
Number of tasks to return per page.
Filter tasks created/due on or after this date (YYYY-MM-DD).
Filter by assignee user ID.
Filter by lead source ID.
Filter by life professional ID.
Filter by lead source category ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_SERVICE_TICKET_LISTRetrieves a paginated list of service tickets from AgencyZoom. Supports filtering by: - Status (0=removed, 1=active, 2=completed) - Priority ID and Category ID Returns service ticket details including subject, description, dates, assignment information, and workflow stage. Results are paginated with default page size of 20 tickets per page.
Input parameters
The page number to retrieve (0-indexed). Defaults to 0 if not specified.
Filter by service ticket status: 0 for 'removed', 1 for 'active', or 2 for 'completed'. If not specified, returns all statuses.
The number of service tickets to return per page. Defaults to 20 if not specified.
Filter by service ticket category identifier. Use 0 to return all categories.
Filter by service ticket priority identifier. Use 0 to return all priorities.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_TEXT_DETAIL_THREADRetrieves detailed messages for a specific SMS/text thread by its thread ID. Returns all messages in the thread with their content, attachments, sender/recipient information, and metadata. The thread ID can be obtained from the search_sms_threads action.
Input parameters
The unique identifier of the SMS/text thread to retrieve details for. This ID can be obtained from the search_sms_threads action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UNLINK_A_DRIVER_FROM_OPPORTUNITYUnlinks a currently associated driver from an AgencyZoom opportunity, used when the driver is no longer relevant, for policy or data updates, potentially impacting the opportunity's status or associated policy details.
Input parameters
Identifier for the driver to be unlinked from the opportunity.
Identifier for the opportunity from which the driver will be unlinked.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UNLINK_A_VEHICLE_FROM_OPPORTUNITYUnlinks a specific, existing vehicle from a specific, existing opportunity using their respective IDs, removing only the association and not the records themselves.
Input parameters
The unique identifier of the vehicle to be unlinked from the specified opportunity.
The unique identifier of the opportunity from which the vehicle will be unlinked.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UNREAD_THREADUpdates the read or unread status of a specific email thread within AgencyZoom.
Input parameters
The unique identifier of the email thread whose read status is to be updated.
Set to true to mark the thread as unread, or false to mark it as read.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UPDATE_A_DRIVER_S_DETAILSUpdates an existing driver's details in AgencyZoom, requiring `driverId` in the path and `firstName` and `lastName` in the request.
Input parameters
Gender of the driver. Valid values are: "M" (Male), "F" (Female), "U" (Unknown), "X" (Non-Binary).
The date of birth of the driver. Must be in MM/DD/YYYY format.
The unique identifier for the opportunity driver whose details are to be updated.
The last name of the driver.
The first name of the driver.
The middle name of the driver.
Relationship status of the driver. Valid values are: "IN" (Named Insured), "SP" (Spouse), "PA" (Parent), "CH" (Child), "OT" (Other).
The driver's license number.
Marital status of the driver, represented by an integer code. Valid codes are: 1 (Single), 2 (Married), 3 (Widowed), 4 (Separated), 5 (Divorced), 6 (Domestic Partner), 7 (Civil Union), 8 (Fiancé / Fiancée), 9 (Unknown), 10 (Other).
The state where the driver is licensed, using its two-letter abbreviation (e.g., NY for New York).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UPDATE_A_LEAD_FILE_NAMEUpdates a lead's file name to `newFileName`; requires `fileId` of the target file, which must be associated with both the `leadId` (path parameter) and the provided `customerReferralId`.
Input parameters
The unique identifier of the file to be renamed. This file must exist and be associated with the specified lead.
The unique identifier of the lead whose file needs to be renamed.
The desired new name for the file. Should include the file extension (e.g., '.pdf', '.docx').
The identifier of the customer referral associated with the lead file. This may be required depending on the file's association in the AgencyZoom system.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UPDATE_A_LEAD_OPPORTUNITYUpdates an existing opportunity's details (carrier, product line, premium, items, custom fields) for a specific lead; `leadId`, opportunity `id`, `carrierId`, and `productLineId` must refer to existing entities.
Input parameters
Unique identifier of the opportunity to update.
Number of items associated with this opportunity (e.g., policies, vehicles).
Unique identifier of the lead.
The premium amount for this opportunity. It is recommended to use the base currency unit (e.g., USD). Please verify the exact currency and format (e.g., cents or dollars) with AgencyZoom's API documentation.
Unique identifier of the insurance carrier.
A list of custom fields to update for the opportunity. For date-type custom fields, ensure the value is formatted as 'MM/DD/YYYY'.
Unique identifier of the product line.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UPDATE_A_LEAD_QUOTEUpdates an existing quote for a specified lead in AgencyZoom when its details require revision, ensuring the provided `leadId` (path parameter), quote `id` (body parameter), `carrierId`, and `productLineId` are valid and correspond to existing entities.
Input parameters
The unique identifier of the quote to be updated.
The number of items covered by the quote (e.g., number of vehicles in an auto policy).
The unique identifier of the lead for which the quote is being updated. This is a path parameter.
The total premium amount for the quote, in cents (e.g., 10000 for $100.00).
The unique identifier of the insurance carrier associated with this quote.
A list of custom field objects to update for the quote. Each object should specify the `fieldName` and its corresponding `fieldValue`.
The unique identifier of the product line (e.g., Auto, Home) for this quote.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UPDATE_AN_OPPORTUNITYUpdates an existing opportunity with the provided details; ensure any custom field names are predefined in AgencyZoom configuration.
Input parameters
Number of items (e.g., policies, vehicles) related to the opportunity.
Premium amount.
Insurance carrier identifier.
Policy or opportunity expiration date (MM/DD/YYYY).
List of custom fields to update. For date-types, use MM/DD/YYYY format.
The unique identifier for the opportunity to update.
Product line identifier.
Property's ZIP code.
Property's city name.
Property's state code (e.g., FL).
Property's country code (e.g., USA).
Property's primary address line.
Property's secondary address line (e.g., apartment, suite).
Set to 1 to use lead's mailing address as property location, 0 otherwise. If 1, lead's address overwrites property address.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UPDATE_A_POLICYUpdates an existing insurance policy for the given `policyId`; monetary values must be in cents and dates in YYYY-MM-DD format.
Input parameters
Number of items covered (e.g., vehicles for auto policy, properties for property policy).
Unique identifier of the agent or producer who sold the policy.
Total premium amount for the policy term, in cents (e.g., $123.45 is 12345).
Unique identifier of the policy to be updated (specified in the request path).
Date policy was sold or bound (Format: YYYY-MM-DD).
Broker fee for the policy, in cents (e.g., $50.00 is 5000).
Unique identifier of the insurance carrier.
Code to associate the policy with a specific group for internal tracking or reporting.
Date policy coverage ends (Format: YYYY-MM-DD).
Identifier for the type of policy transaction (e.g., New Business, Renewal).
Name(s) of the insured party or parties (individual or company).
Identifier for the agency branch or location associated with this policy.
Unique identifier for the lead source (e.g., referral, website).
Unique alphanumeric string assigned to the policy by the insurance carrier.
Date policy coverage begins (Format: YYYY-MM-DD).
Code to assign the policy to a specific department (e.g., Personal Lines, Commercial Lines).
Expiry date of the previous policy (Format: YYYY-MM-DD), if applicable.
Name of the previous insurance company, if applicable.
Policy number of the previous insurance policy, if applicable.
Identifier for the policy's product category (e.g., Auto, Home, Commercial).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UPDATE_A_VEHICLE_S_DETAILSUpdates details for an existing vehicle within an opportunity; this action cannot be used to create new vehicle records.
Input parameters
The Vehicle Identification Number (VIN) of the vehicle. Typically a 17-character string.
The manufacturer of the vehicle.
The manufacturing year of the vehicle.
The model of the vehicle.
The ownership status of the vehicle. Defaults to 'Owned' if unspecified or if an empty string is provided.
The unique identifier of the opportunity vehicle to be updated.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UPDATE_BUSINESS_LEADUpdates an existing business lead in AgencyZoom. Requires leadId (path parameter) plus core business information fields: firstname, email, name (business name), pipelineId, stageId, leadSourceId, assignTo (producer ID), and country. All other fields are optional and will only update if provided.
Input parameters
'Doing Business As' name if the business operates under a name different from its legal name.
The fax number for the business.
The postal code or ZIP code of the business address.
The city where the business is located.
Federal Employer Identification Number (FEIN) or Federal Tax ID for the business.
The legal name of the business or company.
The unique identifier of the Customer Service Representative (CSR) assigned to the business lead.
The primary email address of the business or primary contact.
Additional notes or comments about the business lead.
The primary phone number of the business.
The state or province where the business is located (e.g., CA, TX, NY).
The X-date (e.g., policy expiration or renewal date) associated with the business lead, preferably in YYYY-MM-DD format.
Unique identifier (used in URL path) of the existing business lead to update.
The country where the business is located (e.g., US, CA).
The annual payroll amount for the business.
The unique identifier of the stage within the specified pipeline where the business lead will be placed.
The unique identifier (ID) of the producer or agent to whom the business lead is assigned.
The last name of the primary contact person for the business lead.
The date when the business lead was marked as sold, preferably in YYYY-MM-DD format.
A single string containing multiple tag names, separated by semicolons (;). These tags help categorize or segment the business lead.
The first name of the primary contact person for the business lead.
The group code associated with the business lead, if applicable.
A list of unique identifiers for other Customer Service Representatives (CSRs) also assigned to or associated with this business lead.
The date when a quote was provided to the business lead, preferably in YYYY-MM-DD format.
The middle name of the primary contact person.
The unique identifier of the sales pipeline to which the business lead will be moved.
The date of the last contact with the business lead, preferably in YYYY-MM-DD format.
The agency location code associated with the business lead, if applicable.
A list of custom field objects, each specifying a field name and its value(s) for the business lead.
The unique identifier of the lead source (e.g., 'Website', 'Referral', 'Trade Show').
The annual revenue of the business.
The primary street address of the business.
The department code associated with the business lead, if applicable.
A list of unique identifiers for other producers or agents also assigned to or associated with this business lead.
An alternative or secondary email address for the business or contact.
An alternative or secondary phone number for the business.
The unique identifier of the assignment group responsible for the business lead.
The total number of employees working for the business.
The next important expiration date related to the business lead (e.g., current policy expiration), in MM/DD/YY format.
Additional street address information (e.g., suite, floor, or building number).
The year when the business was established or started operations.
The unique identifier of the business classification code. Use the search_business_classifications action to get available classifications.
The number of years of management experience for the business owner or primary contact.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UPDATE_CUSTOMERUpdates an existing customer's information in AgencyZoom using their unique customerId.
Input parameters
Postal or ZIP code of the customer's address.
City of the customer's address.
The ID of the Customer Service Representative (CSR) assigned to the customer.
Customer's primary email address.
Customer's primary phone number.
State or province of the customer's address (e.g., CA, NY).
The ID of the producer or agent assigned to the customer.
Country of the customer's address (e.g., USA, Canada).
Customer's date of birth (MM/dd/YYYY format).
Customer's last name.
Semicolon-separated string of tag names to associate with the customer (e.g., 'Lead;VIP;Past Client').
Customer's first name.
Customer's creation date (MM/dd/YYYY format).
Unique identifier for the customer to be updated. This value will also be used as the `customerId` in the API request path.
Indicates if the customer is a business. Use 1 for a business customer, 0 for an individual customer.
List of custom fields to update. Each item specifies `fieldName` and `fieldValue`. Date-type custom field values must be in 'MM/dd/YYYY' format.
Total payroll of the business. Applicable only if `bizCustomer` is 1 (commercial customer).
Annual revenue of the business. Applicable only if `bizCustomer` is 1 (commercial customer).
Customer's street address.
Customer's secondary email address.
Customer's secondary phone number.
Last name of the primary contact, typically for business customers.
First name of the primary contact, typically for business customers.
Middle name of the primary contact, typically for business customers.
Number of employees. Applicable only if `bizCustomer` is 1 (commercial customer).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UPDATE_LEADUpdates an existing lead's information in AgencyZoom using the `leadId`; ensure the `leadId` corresponds to an existing lead in AgencyZoom.
Input parameters
Postal or ZIP code of the lead's address.
City of the lead's address.
Name of the organization, if the lead is a business entity.
Identifier of the Customer Service Representative (CSR) assigned to the lead.
Lead's primary email address.
Additional notes or comments related to the lead.
Lead's primary phone number.
State or province of the lead's address.
Policy expiration date or key future date for lead's insurance needs (e.g., YYYY-MM-DD or MM/DD/YY), often policy renewal or X-date.
The unique identifier of the lead to be updated.
Country of the lead's address.
Identifier of the stage the lead is currently in within the pipeline.
Identifier of the primary producer or agent to whom the lead is assigned.
Lead's date of birth in MM/DD/YY format.
Lead's last name.
Lead's nickname.
Date lead was marked as sold (e.g., YYYY-MM-DD).
A single string containing tag names, separated by semicolons (e.g., 'Hot Lead;Follow Up Q3').
Lead's first name.
Group code associated with the lead.
List of unique identifiers for other Customer Service Representatives (CSRs) also assigned to the lead.
Date quote was provided to the lead (e.g., YYYY-MM-DD).
Indicates if lead is a business entity (true) or an individual (false).
Lead's middle name.
Identifier of the sales pipeline the lead belongs to.
Last contact date (e.g., YYYY-MM-DD).
Agency's location code associated with the lead.
A list of custom fields and their values to update for the lead.
Identifier of the source from which the lead originated.
Integer code representing the lead's marital status (e.g., 1 for Single, 2 for Married). Consult AgencyZoom documentation for specific codes.
Lead's street address.
Department code associated with the lead.
List of unique identifiers for other producers or agents also assigned to the lead.
Lead's secondary email address.
Lead's secondary phone number.
Identifier of the assignment group for the lead.
Next policy expiration date relevant to the lead, in MM/DD/YY format.
Additional line for the lead's street address.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UPDATE_LEAD_STATUS_BY_IDUpdates a lead's status (0=ACTIVE, 2=WON, 3=LOST, 5=XDATED) by `leadId`, optionally setting workflow, stage, date, loss reason, X-date type, source, recycle stage/pipeline, or tags; requires `date` and `xDateType` for status 5 (XDATED), and `lossReasonId` for status 3 (LOST).
Input parameters
Optional. The relevant date associated with the status change. If status is XDATED (5), this is the reactivation date. Otherwise, it can be the contact or quoted date. Format: ISO 8601 string (e.g., YYYY-MM-DDTHH:mm:ssZ).
The unique identifier for the lead whose status is to be updated.
The new status for the lead. Allowed values are 0 (ACTIVE), 2 (WON), 3 (LOST), 5 (XDATED).
Optional. A list of tag identifiers (integers) to be applied to or updated on the lead.
Optional. The identifier of the target workflow stage to move the lead to. This can be used for general stage movements.
Optional. A descriptive name for the X-date recycle event (e.g., 'Renewal Reminder', 'Policy Expiration'). Used when `status` is 5 (XDATED) to specify the nature of the future follow-up.
Optional. Identifier of the workflow to associate with the lead.
Optional. The identifier for the reason a lead was lost, referencing an entry in the `leadLossReason` table. Typically used when `status` is 3 (LOST).
Optional. The identifier of the stage to which the lead should be moved if it's being recycled.
Optional. Identifier of the specific stage within a workflow.
Optional. The identifier of the pipeline to which the lead should be moved if it's being recycled.
Optional. The identifier for a new lead source, referencing an entry in the `leadSource` table. Use this to update the lead's origin.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UPDATE_MY_PROFILEUpdates the profile information (first name, last name, email, and optional phone) for the currently authenticated user in AgencyZoom; the provided email address must be unique within the system.
Input parameters
The user's email address. This must be unique within the AgencyZoom system.
The user's optional phone number.
The user's last name.
The user's first name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UPDATE_TAGS_FOR_A_POLICYAdds new comma-separated `tagNames` to a policy, requiring `tagNames` and identification by either `policyId` or `amsPolicyId`; if `amsPolicyId` is provided, `policyId` is ignored, and existing tags are not affected.
Input parameters
The unique identifier of the policy within AgencyZoom. This field is ignored if `amsPolicyId` is provided.
A comma-separated string of tag names to add to the policy. For example, 'New Lead,Follow Up'.
The unique identifier of the policy as recognised by the Agency Management System (AMS). If provided, this ID is used to locate the policy.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_UPDATE_TASKModifies an existing AgencyZoom task (which must be valid and identified by `taskId` in the path) with new attributes from the request body, which must also contain `taskId`.
Input parameters
Task type ('call', 'email', 'meeting', 'todo'); highly recommended.
Title or name of the task; highly recommended for identification.
Unique ID of an existing lead to link to this task; must be an existing lead if provided.
The unique identifier of the task to update. This is specified in the URL path parameter.
Additional notes, comments, or description for the task.
Expected task duration in minutes, typically for 'call' or 'meeting' types.
List of email addresses for invitees, typically for 'meeting' type tasks.
Unique ID of the AgencyZoom user to assign the task; must be an existing user if provided.
Unique ID of an existing customer to link to this task; must be an existing customer if provided.
Due date and time, preferably in ISO 8601 format (e.g., 'YYYY-MM-DDTHH:MM:SSZ').
Email of the customer/lead to associate with the task; used if `customerId` or `leadId` is not provided.
If `True`, the time in `dueDatetime` is specific; otherwise, task is due anytime on `dueDatetime`'s date.
Unique ID of the Life & Health Professional for this task, for specific insurance workflows.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AGENCYZOOM_V4_SSO_LOG_THE_USER_INLogs a user into the AgencyZoom platform via Single Sign-On (SSO). Returns JWT on success or error details on authentication failure.
Input parameters
User's password for SSO authentication.
User's email address, serving as their username for the SSO login.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 58 agents privately built on Nagent that already use AgencyZoom.
Build on Nagent
Connect AgencyZoom to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find AgencyZoom, and click "Connect Now." You'll authenticate with API_KEY, BASIC_WITH_JWT — Nagent handles credential storage and refresh automatically. Once connected, AgencyZoom is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once AgencyZoom is connected, you configure its 99 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop AgencyZoom steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a AgencyZoom event fires, the agent kicks off automatically.
Every AgencyZoom action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While AgencyZoom ships with 99 pre-built crm actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching AgencyZoom together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build AgencyZoom-based workflows tailored to your business.