Poketto

Getting Started

Get up and running with Simple Feedback API in just a few steps.

Prerequisites

Before you begin, make sure you have:

✅ Active platform account with github (Free)
✅ Access to the dashboard
✅ A project or MVP ready for feedback collection

Step 1: Generate an API Key

Login to your dashboard
Navigate to API Keys section
Click Generate New API Key
Important: Copy and store the key securely - it will only be shown once!

warning
Keep your API key secure and never expose it in client-side code. Rotate keys periodically for better security.

Step 2: Create Your First Form

Go to the Dashboard and select Forms
Click Create Form
Fill in the required fields:
- Title (minimum 3 characters)
- Description (optional)
Add your desired form fields
Important: Set form status to "Public" to receive responses

tip
Only forms with "Public" status can receive responses. Don't forget to publish your form!

Step 3: Make Your First API Call

Here's a simple example to submit a form response:

bash

curl -X POST "https://api.poketto.dev/api/v1/forms/{formId}/submit-response"
-H "X-API-Key: YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{
      "respondent": {
      "email": "user@example.com",
      "name": "John Doe"
   },
   "field_responses": [
      {
         "field_id": "your-field-id",
         "value": "Great service!"
      }
   ]
}'

Step 4: View Your Results

Return to the Forms list in your dashboard
Click on your form title
Review collected responses and summary statistics
Export results if needed

Rate Limits

Be aware of the current rate limits:

Free Tier:

100 requests per hour
3 forms per organization
5 fields per form
100 responses per form

Pro Tier: Coming soon!