A CRM has no public pages, so it takes no form of its own. A Simplest1 Forms site can feed it: each submission sends a webhook, and something you run, an automation tool or a few lines of code, writes the person into your CRM through its API.
1. Make a key on your CRM
- In your CRM, open Integrations, then API keys, and create a key.
- Give it the scopes it needs:
contacts:writeto add contacts, andcontacts:readto look them up first. - Copy the key. It is shown once.
2. Send the form's submissions somewhere
- In your Forms site, open Integrations, then Webhooks, and add one.
- Its URL is where your automation tool (Zapier, Make, n8n and the like) or your own code listens.
- Choose the event submission.created.
Each submission then arrives as JSON, the submission under data: the
form's title as form_title, the address typed in the form's Email field
as email, and every answer under answers, each with its field's
name, label and value. Each request is signed
with the webhook's secret in X-Webhook-Signature, so your code can check
it came from your site.
3. Write the contact into your CRM
From that webhook, call your CRM's API with the key, as
Authorization: Bearer followed by the key:
- Look the person up by their address:
GET https://your-crm.simplest1.com/api/v1/contacts?q=ana@example.com. - If nobody has it, add them:
POST https://your-crm.simplest1.com/api/v1/contacts
{
"name": "Ana Souza",
"emails": ["ana@example.com"],
"tags": ["Website"],
"meta": {"lead_source": "Website"}
}
- To keep what they wrote, add a note on their timeline:
POST https://your-crm.simplest1.com/api/v1/contacts/{id}/timeline
{"kind": "note", "body": "Asked about a rebrand in the spring."}
An address already on a contact is refused with a clear error, so a
person who sends the form twice is not added twice. meta fills your own
fields by their names (see "Add your own fields"). Every endpoint is
described at https://your-crm.simplest1.com/api/docs.
Without a Forms site
The same API takes contacts from anything that can send a request: your own website's form, a booking tool, a spreadsheet script.