Form Setup & Integration

The Setup page is where you'll find everything you need to integrate your form with your website. This includes your form's endpoint URL, API key, and integration guides for different frameworks.

Accessing Setup

Navigate to any form and click on the "Setup" tab in the form's navigation menu. You'll see:

Your form's endpoint URL
Your form's unique API key
Integration guides for HTML, React, Vue, JavaScript, and REST API
A test form to verify your integration

The Setup page is only visible to users with appropriate permissions. If you don't see it, contact the form owner to grant you access.

Understanding Your Endpoint

Your form's endpoint is a unique URL that accepts form submissions. It follows this format:

https://forms-api.basestack.co/v1/s/[KEY]?mode=rest

The [KEY] is your form's unique identifier, which you can find on the Setup page.

The mode=rest query parameter ensures you receive JSON responses instead of HTML redirects, which is essential for programmatic form handling.

Finding Your Form Key

Your form key is displayed prominently on the Setup page. You can:

Copy the Key: Click the copy button to quickly copy your form key
View the Endpoint: See the complete endpoint URL with your key already included

Integration Guides

The Setup page provides step-by-step guides for integrating with:

HTML: Direct form integration using the action attribute
React: Form submission using React hooks and Fetch API
Vue: Form handling with Vue's Composition API
JavaScript: Vanilla JavaScript form submission
REST API: Direct API integration for any backend

Each guide includes:

Prerequisites and requirements
Step-by-step instructions
Complete code examples
Best practices and tips

Testing Your Integration

The Setup page includes a test form that you can use to verify your integration is working correctly. Simply:

Fill out the test form with sample data
Submit the form
Check the Submissions page to confirm the submission was received

Always test your form integration before deploying to production. This helps catch configuration issues early.

Form Status Requirements

Before your form can accept submissions, ensure:

Form is Enabled: Check the General Settings to ensure the form is enabled
Data Retention is Enabled: Submissions must be stored to appear in your dashboard

If your form is disabled or data retention is off, submissions will be rejected. Check the banners on the Setup page for status warnings.

Next Steps

After setting up your form:

Configure Settings: Customize form behavior, security, and notifications
Set Up Notifications: Configure email notifications for new submissions
- Learn about Notifications →
View Submissions: Monitor incoming form submissions
- Learn about Submissions →