Skip to content
FormSentry FormSentry FormSentry Docs

Quick Start

Get from sign-up to your first spam detection request in under 5 minutes.

1. Create an Account

Section titled “1. Create an Account”

Sign up for free at app.formsentry.ai/sign-up.

2. Get Your API Key and Form ID

Section titled “2. Get Your API Key and Form ID”
  1. Go to Settings and copy your API key (starts with fs_)
  2. Go to Forms → Create Form and copy the Form ID

3. Make Your First Request

Section titled “3. Make Your First Request”

Open a terminal and run:

Terminal window
curl -X POST https://api.formsentry.ai/v1/verify \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "formId": "YOUR_FORM_ID",
    "payload": {
      "name": "John Doe",
      "email": "john@example.com",
      "message": "Hi, I am interested in your services."
    }
  }'

Replace YOUR_API_KEY and YOUR_FORM_ID with your actual values.

4. Read the Response

Section titled “4. Read the Response”
{
  "status": "legitimate",
  "confidence": 0.95,
  "reasoning": "The submission appears to be from a legitimate user",
  "submissionId": "sub_4d1330a0274a46bd",
  "processingTime": 245,
  "formId": "your-form-id"
}
FieldDescription
status"legitimate" or "spam"
confidenceScore from 0 to 1
reasoningWhy the decision was made
submissionIdUnique ID for this submission
processingTimeProcessing time in milliseconds

5. Integrate Into Your App

Section titled “5. Integrate Into Your App”

Here’s a minimal Node.js example:

const response = await fetch('https://api.formsentry.ai/v1/verify', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apiKey: process.env.FORMSENTRY_API_KEY,
    formId: process.env.FORMSENTRY_FORM_ID,
    payload: { name, email, message }
  })
});


const result = await response.json();


if (result.status === 'spam') {
  // Silently reject or flag for review
} else {
  // Process the legitimate submission
}

Next Steps

Section titled “Next Steps”