Skip to content
formcrier
Start free
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-staging.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.