Send Typeform responses to GuardenerAI.

Step by step

1. Pick the middle step

   With Zapier, start from Typeform’s New Entry trigger. With Make, use Typeform’s Watch Responses. With n8n, point a Typeform webhook (Connect, Webhooks in Typeform) at an n8n Webhook node. Each of these then calls the GuardenerAI API with your key.

2. Map answers by ref, not by position

   Typeform sends answers as a list under form_response.answers, each with its question’s field.ref and the value under a key named for its type, such as text or email. Match on the ref, so reordering the form does not break the mapping.

3. Search, then create or update

   Search leads with filter=email:equals: and the lower-cased email. If a lead comes back, update it with PUT, sending the whole record; if not, create it with POST /api/leads. Typeform retries deliveries that fail or time out, so the search also stops a retried response from becoming a second lead.

4. Or write a small function

   If you would rather not use an automation tool, a function on any serverless host can take the webhook. Set a secret on the Typeform webhook and check the Typeform-Signature header before trusting the body: it is sha256= plus the base64 HMAC-SHA256 of the raw body, keyed with your secret.

   Copy

   import crypto from 'node:crypto';
   const API = 'https://YOUR-ORG.guardenerai.com/api/leads';
   const H = { 'X-Api-Key': process.env.GUARDENERAI_KEY, 'Content-Type': 'application/json' };
   
   export async function handle(rawBody, signature) {
     const expected = 'sha256=' + crypto.createHmac('sha256', process.env.TYPEFORM_SECRET)
       .update(rawBody).digest('base64');
     if (signature !== expected) return 401;
   
     const answers = JSON.parse(rawBody).form_response.answers;
     const by = (ref) => answers.find((a) => a.field.ref === ref);
     const lead = {
       firstName: by('first_name')?.text,
       lastName: by('last_name')?.text,
       email: by('email')?.email.trim().toLowerCase(),
       message: by('project')?.text,
       sourceMedium: 'typeform'
     };
   
     const found = await (await fetch(API + '?filter=email:equals:' + encodeURIComponent(lead.email), { headers: H })).json();
     const res = found.totalElements > 0
       ? await fetch(API + '/' + found.content[0].id, { method: 'PUT', headers: H, body: JSON.stringify({ ...found.content[0], ...lead }) })
       : await fetch(API, { method: 'POST', headers: H, body: JSON.stringify(lead) });
     return res.status;
   }