---
name: formbricks-customer-survey
title: Formbricks Customer Information Collection Survey Creation
description: Skill for creating customer information collection surveys in Formbricks using Management API with specific field requirements.
---

## Overview
Skill for creating customer information collection surveys in Formbricks using Management API with specific field requirements.

## Required Fields
- 姓名（必填）
- 公司名称（必填）
- 电子邮箱（必填）
- 手机号码（必填）
- 备注（可选）

## API Configuration
- Base URL: https://form.140103.xyz
- API Key: 33513637d4161852807df0eeb734da61
- environmentId: cmlw3055s0008xh6f9aod3sko
- Authentication: x-api-key header

## Common Issues & Solutions

### 1. API Format Errors
**Problem**: "Fields are missing or incorrectly formatted" errors, especially with endings format
**Solution**: Use the correct endings structure with proper language codes and question IDs

### 2. Login Issues
**Problem**: Browser login failures with pre-configured credentials
**Solution**: Use API authentication instead of browser login when possible

### 3. Questions Array Format
**Problem**: Questions array structure not accepted
**Solution**: Follow Formbricks API specification for question objects with proper field types

## API Endpoint
POST /api/v1/management/surveys

## Authentication Header
x-api-key: 33513637d4161852807df0eeb734da61

## Survey Payload Structure
```json
{
  "name": "客户信息收集问卷",
  "description": "用于收集客户基本信息的问卷",
  "environmentId": "cmlw3055s0008xh6f9aod3sko",
  "published": true,
  "endings": {
    "zh": {
      "thankYou": "感谢您的填写！",
      "nextSurveyId": null
    }
  },
  "questions": [
    {
      "id": "name",
      "type": "short_text",
      "label": {
        "zh": "姓名"
      },
      "required": true
    },
    {
      "id": "company",
      "type": "short_text",
      "label": {
        "zh": "公司名称"
      },
      "required": true
    },
    {
      "id": "email",
      "type": "email",
      "label": {
        "zh": "电子邮箱"
      },
      "required": true
    },
    {
      "id": "phone",
      "type": "tel",
      "label": {
        "zh": "手机号码"
      },
      "required": true
    },
    {
      "id": "remarks",
      "type": "long_text",
      "label": {
        "zh": "备注"
      },
      "required": false
    }
  ]
}
```

## Troubleshooting Steps
1. If API returns format errors, verify endings structure matches the above example
2. Ensure all required fields are included with correct types
3. Use proper language codes (zh for Chinese)
4. Check API key and environmentId are correct
5. If browser login fails, use API authentication instead

## Verification
After creation, verify survey exists by:
1. Using GET /api/v1/management/surveys to list surveys
2. Checking the survey appears in the list
3. Retrieving the survey details to confirm all questions are present

## Notes
- The survey will be created in the production environment
- The share link can be obtained from the survey details after creation
- If issues persist, check Formbricks API documentation for latest format requirements