Connect Your Website Forms to Your QuiqSol CRM

There are two ways to connect a website form to your QuiqSol CRM, depending on whether you're building the form in QuiqSol or already have one on your own site.

Option 1: Build the form in QuiQ Forms (recommended — no code)

This is the fastest path, and every submission becomes a real CRM record automatically.

1. Create the form. Go to Forms → Create form, then either describe what you need in plain English ("a demo request form for enterprise buyers") and let AI build it, import an existing form from a URL, start from a template, or start from scratch.
2. Open the CRM Mapping tab on the form builder. Turn on "Send responses to CRM automatically."
3. Choose what a submission creates — Lead, Contact, or Company — under "Create or update a." Most website forms (contact us, request a demo, download a guide) should map to Lead, since that's unqualified prospect data your team hasn't verified yet.
4. Set a match field (optional but recommended) — usually Email. This means a second submission from the same person updates their existing record instead of creating a duplicate.
5. Set a Lead source — Website, Referral, Advertisement, or Other.
6. Map your fields. For each field in your form, choose the CRM field it should write to (Email → email, Name → first/last name, Company → companyName, etc.). Any field left unmapped is still saved on the submission itself, just not written to the CRM record.
7. Publish the form, then click Share to get an embeddable iframe or a direct link. Drop either into your website.

From here, every submission appears in CRM → Leads within seconds. If the visitor arrived via a tracked campaign (a utm_campaign parameter in the URL), the Analytics → Campaign Intelligence view will automatically trace that submission through to the lead, the deal it becomes, and the satisfaction score you eventually collect — no manual cross-referencing.

Option 2: Keep your own form, send it to QuiqSol via the API

If you already have a form on your site and don't want to rebuild it in QuiQ Forms, you can POST its data straight into your CRM as a Lead.

1. Generate an API key. Go to Developer → API Keys → New key, name it something like "Website contact form," and copy the key — it's only shown once.
2. Point your form's submit handler at:

   POST https://api.quiqsol.com/public/v1/leads
   Authorization: Bearer <your-api-key>
   Content-Type: application/json
   

3. Send the fields you have. firstName and lastName are required; everything else is optional:

   {
     "firstName": "Ada",
     "lastName": "Lovelace",
     "email": "ada@example.com",
     "phone": "+2348012345678",
     "companyName": "Analytical Engines Ltd",
     "source": "WEBSITE",
     "customFields": { "message": "Interested in the Growth plan" }
   }
   

4. Never call this from a public web page's client-side JavaScript with the key inline — that exposes it to anyone who views your page source. Send the form to your own backend first, and have your backend make this call with the key.

A successful call returns { "id": "<lead id>" } and the Lead shows up in CRM → Leads immediately, same as Option 1.

Troubleshooting

• Getting duplicate Leads for the same person? In Option 1, set a match field (Email is almost always right) in the CRM Mapping tab. Option 2 doesn't dedupe automatically — check for an existing Lead by email in your own logic before calling the API if that matters to you.
• A submission didn't create a CRM record. CRM mapping is best-effort by design — the form submission itself is never lost even if the CRM write fails for some reason (e.g. a required field was left unmapped). Check the submission in Forms → Submissions for its raw answers regardless.
• Want a Contact or Company instead of a Lead? Change "Create or update a" in the CRM Mapping tab — useful for forms aimed at existing customers rather than new prospects.