[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Qualify and convert new SuiteCRM leads

> Read new SuiteCRM leads, convert the qualified ones into contact, account and opportunity by your rule, and mark junk Dead. Runs daily.

Source: https://cotlet.dev/integrations/suitecrm-api-mcp-server/convert-qualified-leads

Web forms and trade-show lists fill the Leads module with status New, and each one has to be opened, judged and either converted or closed before it goes cold.

Cotlet does it in your own SuiteCRM account with list\_records, get\_record, list\_related, convert\_lead and update\_record, called by your AI agent, an n8n workflow or a script.

[Sign up free](https://cotlet.dev/app/signup?app=suitecrm) [All SuiteCRM tools](https://cotlet.dev/integrations/suitecrm-api-mcp-server.md)

Hosted · nothing to install or maintain

## Can SuiteCRM do this on its own?

SuiteCRM has no automatic lead qualification, and its v8 API documents no Convert Lead call (checked 23 Oct 2026). Through the API a developer creates the contact, account and opportunity and links them one by one, after an admin creates an OAuth2 client.

## How you do it in SuiteCRM today

1. In Leads, filter the list by Status New, or switch on My Items to see only leads assigned to you.
2. Open each lead's Detail View and read Lead Source, Account Name, Title and the Activities and History tiles.
3. Select Convert Lead from the Actions drop-down, then work through the Contact, Account and Opportunity sections, which SuiteCRM pre-fills from the lead.
4. For each section, either create a new record or deselect Create and pick an existing one; if SuiteCRM shows a duplicate warning, decide whether to create anyway.
5. Click Save. A lead that is not worth it gets its Status changed by hand to Dead or Recycled.

## How to qualify and convert new SuiteCRM leads

Prompt

```
Go through leads in SuiteCRM with status New. Convert the ones whose company has a website and a real contact email, create an opportunity for each, and mark obvious junk as Dead. Leave the rest for me.
```

1. 01  
### Read the queue  
list\_records runs on Leads with status New and follows next\_cursor to the end, so the whole backlog is judged as one batch. Leads you cannot see because of your role or Security Groups are not in it.
2. 02  
### Apply your rule  
get\_record reads each lead's Account Name, Title, Lead Source and Website. The agent matches them to your rule, for example "has a Website and a Title", and quotes the field it relied on.
3. 03  
### Look for earlier contact  
list\_related reads the lead's Activities and History. A lead with a logged call or an archived email is never marked Dead, only listed for you.
4. 04  
### Convert the matches  
convert\_lead runs Convert Lead for each match with the opportunity name, amount, close date and Sales Stage from your prompt. When SuiteCRM reports a duplicate, the agent stops on that lead and returns the matching record instead of creating a second one.
5. 05  
### Close the junk  
update\_record sets Status to Dead on obvious junk, such as a lead with no contact details at all. Everything ambiguous stays New with a one-line reason.

### What you get back

Example data

```
New leads read: 17
Converted 8 (e.g. Ana Lopez, Northwind Dental: opportunity "Onboarding", Qualification)
Marked Dead 3 (no email, no company)
Duplicate found 1: Tom Becker already exists as a Contact
Left for you 5
```

### Other ways to ask

- Every Monday, convert leads from the Trade Show source that have a Title and list the rest.
- Show me new leads with their Lead Source and last activity, and convert nothing.
- Convert leads with an Account Name that already exists, linking them to that Account instead of creating one.
- Mark leads Recycled when they are older than their Campaign and have no activity.

## What SuiteCRM allows, and what to know first

- SuiteCRM leads carry a Status of New, Assigned, In Process, Converted, Recycled or Dead.
- SuiteCRM fills the Convert Lead screen from the lead's data and, for each of Contact, Account and Opportunity, lets you create a record or pick an existing one.
- On a Lead, Account Name is plain text; it becomes a full Account relationship only on conversion.
- Do Not Call and Email Opt Out carry over from the lead to the new Contact.
- SuiteCRM Security Groups decide which records a user sees, so the agent only converts leads its account can see.

convert\_lead asks for your OK by default. To run it daily without you, switch confirmation off for that tool in your dashboard.

Sources: [SuiteCRM 8 Guide: Leads](https://docs.suitecrm.com/8.x/user/sales-relationships/leads/) · [SuiteCRM 8 Guide: Searching](https://docs.suitecrm.com/8.x/user/core-concepts/searching/) · [SuiteCRM 8 Guide: Security Groups](https://docs.suitecrm.com/8.x/user/appendix/security-groups/) · [SuiteCRM Docs: API v8 endpoints](https://docs.suitecrm.com/developer/integration-api/v8/endpoints/)

## Call convert\_lead from a script

curl

```
curl -X POST https://cotlet.dev/api/v1/suitecrm/leads/5c1e7d0a-3b42-8f19-a6d4-2e7b90c1f3a8/convert \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"create_opportunity":true,"opportunity_name":"Northwind Dental: onboarding","amount":4800,"close_date":"2026-12-15","sales_stage":"Qualification"}'
```

Example response

```
{
"lead_id": "5c1e7d0a-3b42-8f19-a6d4-2e7b90c1f3a8",
"status": "Converted",
"contact_id": "d4a8e1b6-72c3-4f09-9a15-0b6e3c8f2d71",
"account_id": "3d6b0f92-a1e4-47c8-8b25-c9e17f40a6d2",
"opportunity_id": "8f2a41c7-6d3e-90b5-17ac-4e5d0b9a2c61",
"duplicate_check": "no match"
}
```

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is suitecrm\_write → convert\_lead. Example data.

[Schedule it in n8n, Make, Zapier or cron](https://cotlet.dev/integrations/suitecrm-api-mcp-server.md#automations)

## SuiteCRM tools this automation uses

__Cotlet SuiteCRM tools used to qualify and convert new SuiteCRM leads__
| Tool | Parameters |
| -------------- | ------------------------------------------------------------------------------------------------------------- |
| list\_records | module, query, status, assigned\_to\_me, modified\_since, cursor |
| get\_record | module, record\_id |
| list\_related | module, record\_id, subpanel, cursor |
| convert\_lead | lead\_id, account\_id, contact\_id, create\_opportunity, opportunity\_name, amount, close\_date, sales\_stage |
| update\_record | module, record\_id, fields |

[All 12 SuiteCRM tools with descriptions](https://cotlet.dev/integrations/suitecrm-api-mcp-server.md#tools)

## Frequently asked questions

### Is it safe to connect SuiteCRM to Cotlet?

Yes. You sign in to SuiteCRM yourself, in your own Cloud Browser in the EU, and we never save your password. Your agents only get SuiteCRM once you enable it, every background request is listed, and the browser profile is stored encrypted with AES-256-GCM, the cipher 1Password uses for its vaults. The AI model never sees a login, posts and messages wait for your OK, and Disable for agents cuts access in one click. Independent scanners grade cotlet.dev A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory; live results are on https://cotlet.dev/security.

## More SuiteCRM automations

- [Log a SuiteCRM call and create the follow-up task](https://cotlet.dev/integrations/suitecrm-api-mcp-server/log-call-and-follow-up.md)
- [Answer open SuiteCRM cases with AI](https://cotlet.dev/integrations/suitecrm-api-mcp-server/answer-open-cases.md)
- [Review stale SuiteCRM opportunities and create follow-ups](https://cotlet.dev/integrations/suitecrm-api-mcp-server/review-stale-opportunities.md)
- [SuiteCRM API and MCP server: every tool](https://cotlet.dev/integrations/suitecrm-api-mcp-server.md)
- [All use cases](https://cotlet.dev/use-cases.md)

## Give your agent access to SuiteCRM.

Free 7-day trial with 2,000 credits, no card needed. Cotlet is independent and not affiliated with SuiteCRM.

[Sign up free](https://cotlet.dev/app/signup?app=suitecrm)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.