Contact Leads Instantly From a Form via API (How-To)

If you already have a web form, a landing page, or a CRM capturing leads, you can reach them in seconds instead of hours. The idea is simple: every time a lead comes in, your system sends a POST to the Blind Agents API, the platform creates or updates the contact and its company, and instantly fires the channel you choose — an email, a WhatsApp message, or a call handled by an AI agent. This guide walks you through, step by step, how to contact leads instantly from a form via API.

Most forms end up in an inbox or a spreadsheet someone checks when they get a chance. By the time a human sees the lead and replies, that person is already talking to a competitor. The edge isn't capturing more leads; it's being the first to respond while interest is still hot.

With an API event automation, that first touch no longer depends on someone being available. The trigger is automatic and happens the moment the form is submitted, no matter the hour or the day.

• Reply in seconds, not hours — the lead hears from you while your brand is still top of mind.
• Zero manual work — nobody copies data around or has to remember to follow up.
• Multichannel — the same event can end in an email, a WhatsApp message, or a voice call, whichever fits that lead best.
• Everything is logged — the contact, its company, and the conversation live in the platform from second one.

The mechanism has three parts. First, an external system — your form, your CRM, Zapier, or Make — sends a POST to the events endpoint with the lead's data. Second, Blind Agents authenticates the request with your organization's API key and creates or updates the contact (and its company). Third, it fires the channel you configured in the automation.

The endpoint is POST https://api.blindagents.com/v1/events, and authentication goes in the BLIND-AGENTS-API-KEY header with your organization's key. A typical body looks like this: {"event":"new_lead","contact":{"name":"Ada","email":"ada@acme.com","phone":"+1..."},"company":{"name":"ACME"}}.

The contact object takes a name, email, and phone. With the email you can fire an email; with the phone, a WhatsApp message or a call. Send whatever you have — the more fields you include, the richer the contact that lands in the platform and the better the agent can carry the conversation.

• A Blind Agents organization with at least one channel ready: an email sender, a WhatsApp number, or a voice number, depending on how you want to reach out.
• Your organization's API key to authenticate requests.
• A form or CRM that can send a webhook / POST (directly or through Zapier or Make).
• An AI agent configured to continue the conversation once the lead replies.

You build the automation inside the platform; the POST just triggers it. Follow these steps:

1. Open the Automations section and click New automation.
2. Under Details, give it a clear name (say, 'Form lead') and choose the API event trigger type.
3. Under Trigger and message, set the event name your system will send (for example, new_lead) and write the opening message for your channel: for email, a template or a subject and body; for WhatsApp, an approved template; for a call, the opening script.
4. Under Agent and delivery, pick the outbound channel (email, WhatsApp, or call), the AI agent that will handle it, and the mode (automatic, copilot, or manual).
5. Save the automation. It now listens for events your system sends under that name.

• Email — send a saved template or set the subject and body directly. Best when the lead left their email.
• WhatsApp — an approved template opens the conversation. Requires a connected WhatsApp number.
• Call — an AI agent calls the lead from a voice number with the script you define and talks in real time.

If your form supports webhooks, point it straight at the events endpoint. If it doesn't, Zapier or Make bridge the gap: build a Zap or scenario that triggers on each form submission and adds a 'Webhooks → POST' step to /v1/events.

1. In your tool (Zapier, Make, or the CRM itself), create a POST action to https://api.blindagents.com/v1/events.
2. Add the BLIND-AGENTS-API-KEY header with your organization's API key.
3. Map the form fields into the JSON body: name, email, and phone inside contact, and the company name inside company.
4. Set the event field to the same name you configured in the automation (for example, new_lead).
5. Send a test lead and confirm the contact appears and the message goes out.

That first fire is just the start. When the lead replies — answers the email, the WhatsApp, or speaks on the call — the AI agent you assigned continues the conversation. In automatic mode it answers on its own; in copilot it drafts replies for your team to approve; in manual it hands a ready conversation to a person. The contact and company already exist, so the whole history stays in one place.

Every automation reports its metrics in the Monitor: how many events came in, how many messages fired, how many were delivered, and — depending on the channel — how many were read or answered. That tells you whether the automatic first touch is working, so you can tune the message, the channel, or the agent without touching your form.