Quickstart

Get from zero to your first submission in under 2 minutes.

1. Sign up at usepostbox.com - a “Try Me” form is created automatically.

2. Find your endpoint in the dashboard. It looks like:

   https://usepostbox.com/api/.../f/{slug}

3. Send a submission (see examples below)

4. Check your dashboard - the submission appears in real-time with spam analysis, language detection, and more.

Send a submission

cURL

curl -X POST https://usepostbox.com/api/.../f/{slug} \
  -H "Content-Type: application/json" \
  -d '{"name": "Ada Lovelace", "email": "ada@example.com", "message": "Hello from the command line"}'

JavaScript

const response = await fetch(
  "https://usepostbox.com/api/.../f/{slug}",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      name: "Ada Lovelace",
      email: "ada@example.com",
      message: "Hello from JavaScript",
    }),
  }
);

What just happened?

When you POSTed data to your endpoint, Postbox:

• Accepted and stored the submission
• Ran spam detection (heuristic by default, AI-powered if enabled)
• Made it available in your dashboard instantly via WebSocket

Next steps

• Set up authentication to use the management API
• Create a custom form with your own schema
• Explore the API for programmatic access