First API Call

Your First API Call

Make your first request to the FeedbackKit API and start collecting contextual feedback.

Prerequisites

Created a FeedbackKit account

Generated an API key

Installed @feedbackkit/widget or have cURL ready

Step 1: Create a Project

Create Your First Feedback Project

Every FeedbackKit widget needs a project ID. Let's create one for your feedback collection.

1. Go to your dashboard at feedbackkit.io/dashboard

2. Click "New Project" and select "Feedback Collection"

3. Give it a name like "My App Feedback"

4. Copy the project ID that starts with "proj_"

Step 2: Submit Your First Feedback

Submit Feedback Entry

Submit feedback with context and see the magic happen

curl -X POST https://api.feedbackkit.io/feedback \
  -H "Authorization: Bearer feedbackkit_sk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "bug",
    "priority": "high",
    "title": "Login button not working",
    "description": "Users cannot click the login button on mobile devices",
    "email": "user@example.com",
    "metadata": {
      "url": "https://myapp.com/login",
      "userAgent": "Mozilla/5.0...",
      "appName": "My App"
    }
  }'

Expected Response

Success Response

Here's what you'll get back when the request succeeds

Responsejson

{
  "id": "feedback_abc123def456",
  "type": "bug",
  "priority": "high",
  "title": "Login button not working",
  "description": "Users cannot click the login button on mobile devices",
  "email": "user@example.com",
  "status": "open",
  "createdAt": "2025-01-15T10:30:00Z",
  "metadata": {
    "url": "https://myapp.com/login",
    "userAgent": "Mozilla/5.0...",
    "appName": "My App",
    "timestamp": "2025-01-15T10:30:00Z"
  }
}

Test It Live

Try the API Explorer

Use our interactive API explorer to test your first call

The API explorer lets you make real API calls with your API key and see the responses immediately.

🎉 Congratulations!

You've successfully made your first API call to FeedbackKit! Here's what you can explore next: