---
title: How does Mav’s Ricochet 360 API Integration work?
description: Instructions on how to connect a Mav account with a Ricochet360 CRM using the API. Connects pipelines and stages with workflows and events related to Leads.
---

[Skip to content](https://knowledge.hiremav.com/connecting-with-ricochet-360-api#main-content)

![Avatar-wide-white-1](https://knowledge.hiremav.com/hs-fs/hubfs/Avatar-wide-white-1.png?width=200&height=100&name=Avatar-wide-white-1.png)

Open main navigation

Close main navigation

 Knowledge Base

- There are no suggestions because the search field is empty.

1. [Knowledge Base](https://knowledge.hiremav.com/?hsLang=en)
2. [Integrations](https://knowledge.hiremav.com/integrations?hsLang=en)

# How does Mav’s Ricochet 360 API Integration work?

## Mav writes lead activity into your Ricochet360 CRM through the Ricochet API - creating leads, moving their status, and logging notes.

### Picking the right Ricochet integration

| #### Card | #### How it sends | #### What it can do |
| --- | --- | --- |
| Rico API (this article) | Authenticated calls to the Ricochet API. Needs an API key. | Creates leads, updates the status of existing leads, and logs notes. Covers 8 moments. |
| Rico Webhooks | Posts leads to a URL you paste in, the way any lead vendor does. No API key. | Creates leads only. No status updates, no notes. Covers 6 events. |

### Connecting the account

1. **Open the Integrations page. Find the Rico API card under Official Integrations and click Configure. 
   
   ![Screenshot 2026-09-17 at 3.06.44 PM](https://knowledge.hiremav.com/hs-fs/hubfs/Screenshot%202026-09-17%20at%203.06.44%20PM.png?width=249&height=216&name=Screenshot%202026-09-17%20at%203.06.44%20PM.png)**
2. **Click Connect to sign into Ricochet. Enter your API key and subdomain. Mav uses them to reach your Ricochet360 account.**   
     
   **![Screenshot 2026-09-17 at 3.06.54 PM](https://knowledge.hiremav.com/hs-fs/hubfs/Screenshot%202026-09-17%20at%203.06.54%20PM.png?width=337&height=227&name=Screenshot%202026-09-17%20at%203.06.54%20PM.png)**
3. **Set your account-wide fields. These apply to every workflow.** 
   
   | #### Field | #### Required | #### What is does |
   | --- | --- | --- |
   | Vendor ID | Required | The vendor assigned to leads Mav creates |
   | Campaign ID | Optional | A campaign to tie leads to. Leave blank if you don’t use campaigns. |
   | Company Campaign ID | Optional | A company campaign to tie leads to. Leave blank if unused |
4. **Turn on the workflows you want. Every workflow starts switched off. Switch on the ones you want, and type a Status ID into each.**

**The eight events Mav sends**

### **The eight events Mav sends**

Each event below has both a Create a Lead workflow and an Update Lead workflow. You can enable either, both, or neither.

| ##### Event | ##### Description | ##### What happened |
| --- | --- | --- |
| `started` | Starts working a lead | Mav sent its first message to the lead |
| `interested` | Catches a positive intent | The lead replied with interest. |
| `party_line_available` | Starts a party line | Mav is dialing to connect the lead to a rep. |
| `party_line_completed` | Completes a party line | A rep connected to the lead on the call. |
| `completed` | Completes a lead | Mav finished its conversation with the lead. |
| `opted_out` | Opts out a lead | The lead asked to stop receiving messages. |
| `undeliverable` | Marks a lead undeliverable | The phone number could not receive messages. |
| `unqualified` | Marks a lead unqualified | Mav decided the lead does not qualify. |

#### How each workflow behaves

Create a Lead

- Searches Ricochet360 for the phone number.
- Stops if that lead already exists.
- Creates the lead.
- Assigns your vendor to it.
- Logs a note with what Mav learned.

Update Pipeline Stage

- Searches Ricochet360 for the phone number.
- Sets that lead to your Status ID.
- Logs Mav's note on the lead.

Pair them up. Update Lead only works on a lead Ricochet360 already has. If your leads do not reach Ricochet360 another way, turn on Create a Lead for your earliest moment, usually **starts working a lead** or **catches a positive intent**. Use Update Lead for everything after that.

 

- [General](https://knowledge.hiremav.com/general?hsLang=en#main-content)

    - [Getting Started](https://knowledge.hiremav.com/general?hsLang=en#getting-started)
- [Lead Delivery](https://knowledge.hiremav.com/lead-delivery?hsLang=en)
- [Integrations](https://knowledge.hiremav.com/integrations?hsLang=en#main-content)

    - [Documentation](https://knowledge.hiremav.com/integrations?hsLang=en#documentation)
- [Analytics, Reporting & Alerts](https://knowledge.hiremav.com/analytics-reporting-alerts?hsLang=en)
- [API](https://knowledge.hiremav.com/api?hsLang=en)
- [Party Line](https://knowledge.hiremav.com/party-line?hsLang=en#main-content)

    - [Feature](https://knowledge.hiremav.com/party-line?hsLang=en#feature)

# Mav Automation Ventures, Inc.

Copyright © 2026, Mav Automation Ventures, Inc.