Converting Leads via API (simply don't convert)

[tecnologiacb]

Hello guys, I'm new here posting to this forum - although I've used it many times searching for answers, so thank you all.
And only recently started to working with EspoCRM.

I've a communication between Mautic and EspoCRM via API.
When a contact submit a form, Mautic webhook campaign send the info to some code and they get inserted in EspoCRM (self hosted) and that is working fine.
The problem is when I try to convert the Lead to a Contact (the coode check if it's needed to convert and if user don't exist yet): it simply marks the Lead as converted in EspoCRM but don't create any Contact.

The code sending the info to EspoCRM API is:

    public function convertLead($data) {
        if($this->auth == 'EspoCRM') {
            $data_jsoned = json_encode($data);
            $this->clientCurlInit("Lead/action/convert");
            curl_setopt($this->curl, CURLOPT_CUSTOMREQUEST, 'POST');
            curl_setopt($this->curl, CURLOPT_POSTFIELDS, $data_jsoned);
            $resp = curl_exec($this->curl);
            return $resp;
        }
    }

It's not my code but I can change it if needed (and will in the future, cause optmization...).
The curlinit and headers (etc) are in other place.
That $data is something like that:

{"id":"67eade8f59e00fa9e","convertEntity":["Contact","Opportunity"]}

The thing is: the Lead is being included perfectly, it's also being marked as converted but not actually being converted to Contact or Opportunity.
No errors found in logs in EspoCRM, Nginx or PHP, just the API responding with:

{"id":"67eade8f59e00fa9e","name":"John Doe","deleted":false,"salutationName":null,"firstName":"John Doe","lastName":null,"title":null,"status":"Converted","source":null,"industry":null,"opportunityAmount":null,"website":null,"addressStreet":null,"addressCity":null,"addressState":null,"addressCountry":null,"addressPostalCode":null,"emailAddress":"example@gmail.com","phoneNumber":"+551199999999","doNotCall":false,"description":"Lorem ipsum","convertedAt":"2025-03-31 18:27:27","createdAt":"2025-03-31 18:27:27","modifiedAt":"2025-03-31 18:27:27","accountName":null,"cInteresse":[],"cTestecampoverificacao":[],"cDeOndeVeio":null,"middleName":null,"opportunityAmountCurrency":null,"emailAddressIsOptedOut":false,"emailAddressIsInvalid":false,"phoneNumberIsOptedOut":false,"phoneNumberIsInvalid":false,"streamUpdatedAt":"2025-03-31 18:27:27","opportunityAmountConverted":null,"emailAddressData":[{"emailAddress":"example@gmail.com","lower":"example@gmail.com","primary":true,"optOut":false,"invalid":false}],"phoneNumberData":[{"phoneNumber":"+551199999999","type":"Mobile","primary":true,"optOut":false,"invalid":false}],"createdById":"67d0830a389edc81e","createdByName":"mautic","modifiedById":"67d0830a389edc81e","modifiedByName":"mautic","assignedUserId":null,"assignedUserName":null,"teamsIds":[],"teamsNames":{},"campaignId":null,"campaignName":null,"createdAccountId":null,"createdAccountName":null,"createdContactId":null,"createdContactName":null,"createdOpportunityId":null,"createdOpportunityName":null,"isFollowed":false,"followersIds":[],"followersNames":{}}

I couldn't find anything related to if I need to send more or different params with the ID in order to convert the Lead. Maybe it's a beginner question (wich prob is) but I just couldn't find anything about how the json must be sent to Laed/action/convert. Is it so basic that no one needed to explain it and I'm noobing too much? lol
Anyway, if anyone can give me an insight it will be very appreciated. And if someone has somewhere where I can learn more things like this (I'm studying the EspoCRM API Docs at https://docs.espocrm.com/development/api/) it will also helps.

Thanks guys!

[tecnologiacb]

I couldn't find a Lead/actions/convert solution, then what I did in order that to work is:

1- Register the Lead and convert ir with no automatic creation of a Contact
2- Check to see if a Contact with the same e-mail exists
3- If it doesnt exist, create one with the info from Mautic
4- Is exists, grab it's ID
5- Link Contact and Lead
6- Create an Opportunity (at this company a new Lead always generates a new Opportunity, so no verification needed)
7- Link Opportunity and Lead
8- Link Contact and Opportunity
9- Link Account and Opportunity
10- Log everything useful

And that's it.
If someone know a better/more elegant solution, please share cause I wanna learn more about Espo.