Set up a form backend in 30 seconds.

Step 1 — Ask the user these 2 questions:

• What information do you need to collect? (e.g. name, email, message, phone, etc.)
• Where should submissions be sent? (email address)

Step 2 — Create the form backend via API:

{
  "name": "Contact form",
  "slug": "contact",
  "fields": [
    { "id": "name", "type": "text", "label": "Name", "required": false },
    { "id": "email", "type": "email", "label": "Email", "required": true },
    { "id": "message", "type": "textarea", "label": "Message", "required": false }
  ],
  "delivery": { "type": "email", "to": "[email protected]" }
}

Step 3 — Publish the form:

Authorization: Bearer <AP...e>
      

Step 4 — Wire the frontend form to POST answers:

const response = await fetch(
  'https://agentsforms.com/api/forms/{FORM_ID}/submissions',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      source: 'site',
      answers: { name, email, message }
    })
  }
);

Base URL & Methods

• POST /api/forms — Create a form from a JSON schema
• GET /api/forms — List all forms
• GET /api/forms/:id — Get a form by ID
• POST /api/forms/:id/publish — Publish a form (creates immutable version)
• POST /api/forms/:id/submissions — Submit answers to a form
• GET /api/forms/:id/submissions — List submissions for a form
• POST /api/demo — Demo endpoint (no auth, stores + emails)

Supported field types

text textarea email url number boolean date select multi_select radio checkbox hidden

Example: contact form with 3 fields

{
  "name": "Contact form",
  "slug": "contact",
  "fields": [
    { "id": "name", "type": "text", "label": "Name", "required": false },
    { "id": "email", "type": "email", "label": "Email", "required": true },
    { "id": "message", "type": "textarea", "label": "Message", "required": false }
  ],
  "settings": {
    "submitLabel": "Send message",
    "successMessage": "Thanks — we'll be in touch."
  }
}

Install and create a form in one flow:

npm install -g @agentsforms/cli
agentsforms login
agentsforms init
agentsforms forms create forms/contact.json --email [email protected]
agentsforms forms publish contact

Email (default)

Submissions are sent to the specified email address via AgentMail.

Webhook (MVP2)

Set "delivery": { "type": "webhook", "url": "https://your-app.com/webhook" } to receive signed webhook events instead of email.

Create a hosted session

{
  "id": "sess_abc123",
  "form_url": "https://agentsforms.com/f/sess_abc123?t=public_token"
}

Share the form_url with users — it's a fully functional hosted form.