Skip to content
Integrations

REST API

Post submissions from any server. They go through the same spam checks, routing and alerts as the script and plugins.

  1. 1

    Create a secret key

    In Integrations & API keys, create a key and store it on your server. Never put it in browser code.

  2. 2

    Send a submission

    Post the fields with their labels. We reply 202 Accepted straight away and send the alerts in the background.

    cURL
    curl https://api.formcrier.com/api/v1/submissions \
      -H "Authorization: Bearer sk_live_ab12…" \
      -H "Idempotency-Key: 5f1c…" \
      -H "Content-Type: application/json" \
      -d '{
        "source": "api",
        "form": { "external_ref": "quote", "name": "Quote request" },
        "fields": [
          { "key": "name", "label": "Name", "type": "text", "value": "Sarah Jones" },
          { "key": "phone", "label": "Phone", "type": "tel", "value": "07700 900123" }
        ],
        "page_url": "https://acmeplumbing.co.uk/quotes"
      }'
  3. 3

    Read the full reference

    Endpoints for listing and syncing forms, error codes and rate limits are in the docs.

Can we use Google Analytics cookies to see which pages and ads bring people here? Say no and we'll only count visits without cookies. Cookies and privacy