Send form entries to your CRM

Updated · 2 min read

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

  1. In your CRM, open Integrations, then API keys, and create a key.
  2. Give it the scopes it needs: contacts:write to add contacts, and contacts:read to look them up first.
  3. Copy the key. It is shown once.

2. Send the form's submissions somewhere

  1. In your Forms site, open Integrations, then Webhooks, and add one.
  2. Its URL is where your automation tool (Zapier, Make, n8n and the like) or your own code listens.
  3. 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:

  1. Look the person up by their address: GET https://your-crm.simplest1.com/api/v1/contacts?q=ana@example.com.
  2. 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"}
}
  1. 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.

Made with Simplest1