> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API Create Questionnaire: Formulir KYC Kustom > Buat kuesioner KYC dan kepatuhan kustom secara terprogram dengan pertanyaan berurutan, opsi, dan 54 terjemahan bahasa. Bayar per panggilan dari Didit. Prompt API Membuat Kuesioner Salin prompt ke papan klip \

\`Create a simple Didit questionnaire through the Management API.

Endpoint:
POST https://verification.didit.me/v3/questionnaires/

Authentication:
Use the x-api-key header with my Didit API key.

Requirements:
\- Use the simple v3 API shape with form_elements.
\- Do not send graph, branches, next, required_if, or conditional logic.
\- Include languages with en and default_language set to en.
\- Use customer-friendly element_type values such as short_text, multiple_choice, email, file_upload, or date_picker.
\- For choice questions, send options with value and label.
\- Store the questionnaire_id from the response because I will use it later as questionnaire_uuid in workflows.

Example request body:
\{
"title": "Customer Onboarding",
"languages": ["en"],
"default_language": "en",
"form_elements": [
\{
  "id": "occupation",
  "element_type": "short_text",
  "label": { "en": "What is your occupation?" },
  "is_required": true
},
\{
  "id": "source_of_funds",
  "element_type": "multiple_choice",
  "label": { "en": "Source of funds" },
  "is_required": true,
  "options": [
    \{ "value": "employment", "label": { "en": "Employment" } },
    \{ "value": "business", "label": { "en": "Business" } },
    \{ "value": "investments", "label": { "en": "Investments" } }
  ]
}
]
}

Build the API call, handle validation errors, and return the questionnaire_id from the response.`

\
Tempel ke Gunakan endpoint ini untuk membuat kuesioner sederhana melalui API. Kirim array `form_elements` sesuai urutan pertanyaan yang harus dijawab pengguna. Didit membangun graf kuesioner internal untuk Anda.API hanya mendukung kuesioner linear sederhana. Jangan kirim `graph`, `branches`, `next`, atau aturan kondisional.## Kolom wajib- `title` adalah nama internal kuesioner. - `languages` harus menyertakan `en`. - `form_elements` harus berisi minimal satu pertanyaan. - Setiap elemen formulir memerlukan `element_type` dan `label` yang sudah diterjemahkan.Anda juga dapat menambahkan `description` opsional yang sudah diterjemahkan ke elemen formulir sebagai teks bantuan. Kolom ini diterima pada setiap jenis elemen kecuali `separator`, dan dikembalikan sebagai `description` item pada [laporan kuesioner](https://docs.didit.me/id/core-technology/questionnaires/report-questionnaire.md).## Jenis elemenGunakan nilai huruf kecil seperti `short_text`, `multiple_choice`, `email`, `file_upload`, atau `date_picker`. Nilai enum huruf besar seperti `SHORT_TEXT` juga diterima.Untuk `dropdown`, `single_choice`, dan `multiple_choice`, tambahkan `options`. Jika Anda menghilangkan `value` pada opsi, Didit akan membuatnya dari label.```json theme={null} { "title": "Customer Onboarding", "languages": ["en"], "default_language": "en", "form_elements": [ { "id": "occupation", "element_type": "short_text", "label": { "en": "What is your occupation?" }, "is_required": true }, { "id": "source_of_funds", "element_type": "multiple_choice", "label": { "en": "Source of funds" }, "is_required": true, "options": [ { "value": "employment", "label": { "en": "Employment" } }, { "value": "business", "label": { "en": "Business" } }, { "value": "investments", "label": { "en": "Investments" } } ] } ] } ```## Validasi kolomTambahkan objek `validation` opsional ke elemen `short_text`, `long_text`, atau `number` untuk menerapkan format pada jawaban pengguna. Ini berguna untuk pengenal dengan format ketat, seperti ID pajak, ID nasional, atau nomor kartu. Validasi dijalankan saat pengguna mengisi kolom (pengguna tidak dapat melanjutkan sebelum validasi lolos) dan API menerapkannya kembali saat jawaban dikirimkan.| Kolom | Berlaku untuk | Deskripsi | | - | - | - | | `pattern` | `short_text`, `long_text` | Ekspresi reguler yang harus cocok sepenuhnya dengan nilai. Gunakan subset ECMA-262 yang portabel; jangan tambahkan anchor `^`/`$` (seluruh nilai akan dicocokkan). | | `min_length` | `short_text`, `long_text` | Jumlah karakter minimum. | | `max_length` | `short_text`, `long_text` | Jumlah karakter maksimum. | | `min` | `number` | Nilai numerik minimum. | | `max` | `number` | Nilai numerik maksimum. | | `error_message` | semua di atas | Pesan yang diterjemahkan dan ditampilkan saat nilai tidak lolos. Jika dihilangkan, sistem menggunakan pesan umum. |```json theme={null} { "title": "Customer Onboarding", "languages": ["en"], "default_language": "en", "form_elements": [ { "id": "tax_id", "element_type": "short_text", "label": { "en": "Tax ID" }, "is_required": true, "validation": { "pattern": "[A-Z]{2}[0-9]{9}", "min_length": 11, "max_length": 11, "error_message": { "en": "Enter a valid Tax ID (2 letters followed by 9 digits)." } } } ] } ```Respons menyertakan `questionnaire_id`. Simpan nilai tersebut, karena Anda akan menggunakannya sebagai `questionnaire_uuid` saat menambahkan kuesioner ke sebuah alur kerja. ## OpenAPI ````yaml id/openapi-25.json POST /v3/questionnaires/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API Verifikasi Identitas. Lakukan autentikasi dengan header x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/questionnaires/: post: tags: - Questionnaires summary: Buat kuesioner description: >- Buat kuesioner linier sederhana. Kirim `form_elements` sesuai urutan tampilan; percabangan dan grup berulang memerlukan Console. Default ke `published` v1. operationId: create_questionnaire requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SimpleQuestionnaireRequest' examples: Simple: summary: Kuesioner dasar value: title: Customer Onboarding description: Additional information needed for verification default_language: en languages: - en is_active: true form_elements: - id: occupation element_type: short_text label: en: What is your occupation? is_required: true placeholder: en: Software engineer - id: source_of_funds element_type: multiple_choice label: en: Source of funds is_required: true options: - value: employment label: en: Employment - value: business label: en: Business - value: investments label: en: Investments - value: other label: en: Other responses: '201': description: >- Kuesioner dibuat. Respons menyertakan `questionnaire_id` — simpan untuk mereferensikan kuesioner ini dari alur kerja atau panggilan pembaruan/penghapusan mendatang. content: application/json: schema: $ref: '#/components/schemas/QuestionnaireDetail' examples: Created: value: questionnaire_id: 11111111-2222-3333-4444-555555555555 title: Customer Onboarding description: Additional information needed for verification languages: - en default_language: en is_active: true is_simple_questionnaire: true graph: start_node: occupation nodes: occupation: element_type: SHORT_TEXT is_required: true title: en: What is your occupation? next: source_of_funds source_of_funds: element_type: MULTIPLE_CHOICE is_required: true title: en: Source of funds choices: - value: employment label: en: Employment - value: business label: en: Business next: null sections: [] questionnaire_group_id: 11111111-2222-3333-4444-555555555555 version: 1 status: published published_at: '2026-04-23T10:00:00Z' is_editable: false '400': description: >- Kesalahan validasi. Penyebab umum: `element_type` yang tidak dikenal, kolom yang dapat diterjemahkan kehilangan terjemahan untuk salah satu dari `languages`, `languages` tidak memiliki `en`, `default_language` tidak ada di `languages`, opsi tanpa `label`, pertanyaan yang memiliki `branches`/`required_if`/`repeatable_config` (tidak didukung oleh endpoint ini), atau mengirimkan `graph` mentah alih-alih `form_elements`. Isi respons adalah kesalahan validasi DRF dengan kunci berupa nama kolom. content: application/json: examples: Graph not accepted: value: graph: >- The v3 questionnaire API only accepts simple `form_elements`, not `graph`. Missing label: value: form_elements: - label: - This field is required. '403': description: >- Kunci API tidak ada, format salah, kedaluwarsa, atau memiliki cakupan untuk aplikasi yang berbeda. content: application/json: examples: Invalid token: value: detail: You do not have permission to perform this action. '415': description: >- Tipe media tidak didukung. Atur `Content-Type: application/json` dan kirim body JSON. '429': description: Batas laju terlampaui. Coba lagi dengan backoff eksponensial. '500': description: >- Terjadi kesalahan server tak terduga saat membuat kuesioner. Aman untuk dicoba lagi. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: cURL source: |- curl -X POST 'https://verification.didit.me/v3/questionnaires/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "title": "Customer Onboarding", "default_language": "en", "languages": ["en"], "form_elements": [ { "id": "occupation", "element_type": "short_text", "label": {"en": "What is your occupation?"}, "is_required": true } ] }' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.questionnaires.create( title="Customer Onboarding", description="Additional information needed for verification", languages=["en"], default_language="en", is_active=True, form_elements=[{ "id": "occupation", "element_type": "short_text", "label": {"en": "What is your occupation?"}, "placeholder": {"en": "Software engineer"}, "is_required": True, }, { "id": "source_of_funds", "element_type": "multiple_choice", "label": {"en": "Source of funds"}, "is_required": True, "options": [{ "value": "employment", "label": {"en": "Employment"}, }, { "value": "business", "label": {"en": "Business"}, }, { "value": "investments", "label": {"en": "Investments"}, }, { "value": "other", "label": {"en": "Other"}, }], }], ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.questionnaires.create({ title: "Customer Onboarding", description: "Additional information needed for verification", languages: ["en"], default_language: "en", is_active: true, form_elements: [{ id: "occupation", element_type: "short_text", label: { en: "What is your occupation?" }, placeholder: { en: "Software engineer" }, is_required: true, }, { id: "source_of_funds", element_type: "multiple_choice", label: { en: "Source of funds" }, is_required: true, options: [{ value: "employment", label: { en: "Employment" }, }, { value: "business", label: { en: "Business" }, }, { value: "investments", label: { en: "Investments" }, }, { value: "other", label: { en: "Other" }, }], }], }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Questionnaires.Create(ctx, didit.SimpleQuestionnaireRequest{\n\tTitle: \"Customer Onboarding\",\n\tDescription: didit.String(\"Additional information needed for verification\"),\n\tLanguages: []string{\"en\"},\n\tDefaultLanguage: didit.String(\"en\"),\n\tIsActive: didit.Bool(true),\n\tFormElements: []didit.SimpleQuestionnaireElement{{\n\t\tID: didit.String(\"occupation\"),\n\t\tElementType: \"short_text\",\n\t\tLabel: map[string]string{\"en\": \"What is your occupation?\"},\n\t\tPlaceholder: didit.Some(map[string]string{\"en\": \"Software engineer\"}),\n\t\tIsRequired: didit.Bool(true),\n\t}, {\n\t\tID: didit.String(\"source_of_funds\"),\n\t\tElementType: \"multiple_choice\",\n\t\tLabel: map[string]string{\"en\": \"Source of funds\"},\n\t\tIsRequired: didit.Bool(true),\n\t\tOptions: didit.Some([]didit.SimpleQuestionnaireElementOptions{{\n\t\t\tValue: didit.String(\"employment\"),\n\t\t\tLabel: map[string]string{\"en\": \"Employment\"},\n\t\t}, {\n\t\t\tValue: didit.String(\"business\"),\n\t\t\tLabel: map[string]string{\"en\": \"Business\"},\n\t\t}, {\n\t\t\tValue: didit.String(\"investments\"),\n\t\t\tLabel: map[string]string{\"en\": \"Investments\"},\n\t\t}, {\n\t\t\tValue: didit.String(\"other\"),\n\t\t\tLabel: map[string]string{\"en\": \"Other\"},\n\t\t}}),\n\t}},\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import java.util.List; import java.util.Map; import me.didit.Didit; import me.didit.types.SimpleQuestionnaireElement; import me.didit.types.SimpleQuestionnaireRequest; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.questionnaires().create(SimpleQuestionnaireRequest.builder() .title("Customer Onboarding") .description("Additional information needed for verification") .languages(List.of("en")) .defaultLanguage("en") .isActive(true) .formElements(List.of( SimpleQuestionnaireElement.builder() .id("occupation") .elementType(SimpleQuestionnaireElement.ElementType.of("short_text")) .label(Map.of("en", "What is your occupation?")) .placeholder(Map.of("en", "Software engineer")) .isRequired(true) .build(), SimpleQuestionnaireElement.builder() .id("source_of_funds") .elementType(SimpleQuestionnaireElement.ElementType.of("multiple_choice")) .label(Map.of("en", "Source of funds")) .isRequired(true) .options(List.of( SimpleQuestionnaireElement.Options.builder() .value("employment") .label(Map.of("en", "Employment")) .build(), SimpleQuestionnaireElement.Options.builder() .value("business") .label(Map.of("en", "Business")) .build(), SimpleQuestionnaireElement.Options.builder() .value("investments") .label(Map.of("en", "Investments")) .build(), SimpleQuestionnaireElement.Options.builder() .value("other") .label(Map.of("en", "Other")) .build())) .build())) .build()); System.out.println(result); - lang: php label: PHP source: |- questionnaires->create([ 'title' => 'Customer Onboarding', 'description' => 'Additional information needed for verification', 'languages' => ['en'], 'default_language' => 'en', 'is_active' => true, 'form_elements' => [[ 'id' => 'occupation', 'element_type' => 'short_text', 'label' => ['en' => 'What is your occupation?'], 'placeholder' => ['en' => 'Software engineer'], 'is_required' => true, ], [ 'id' => 'source_of_funds', 'element_type' => 'multiple_choice', 'label' => ['en' => 'Source of funds'], 'is_required' => true, 'options' => [[ 'value' => 'employment', 'label' => ['en' => 'Employment'], ], [ 'value' => 'business', 'label' => ['en' => 'Business'], ], [ 'value' => 'investments', 'label' => ['en' => 'Investments'], ], [ 'value' => 'other', 'label' => ['en' => 'Other'], ]], ]], ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.questionnaires.create( title: "Customer Onboarding", description: "Additional information needed for verification", languages: ["en"], default_language: "en", is_active: true, form_elements: [{ id: "occupation", element_type: "short_text", label: { en: "What is your occupation?" }, placeholder: { en: "Software engineer" }, is_required: true, }, { id: "source_of_funds", element_type: "multiple_choice", label: { en: "Source of funds" }, is_required: true, options: [{ value: "employment", label: { en: "Employment" }, }, { value: "business", label: { en: "Business" }, }, { value: "investments", label: { en: "Investments" }, }, { value: "other", label: { en: "Other" }, }], }] ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Collections.Generic; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Questionnaires.CreateAsync(new SimpleQuestionnaireRequest { Title = "Customer Onboarding", Description = "Additional information needed for verification", Languages = new string[] { "en" }, DefaultLanguage = "en", IsActive = true, FormElements = new SimpleQuestionnaireElement[] { new() { Id = "occupation", ElementType = "short_text", Label = new Dictionary { ["en"] = "What is your occupation?" }, Placeholder = new Dictionary { ["en"] = "Software engineer" }, IsRequired = true, }, new() { Id = "source_of_funds", ElementType = "multiple_choice", Label = new Dictionary { ["en"] = "Source of funds" }, IsRequired = true, Options = new SimpleQuestionnaireElementOptions[] { new() { Value = "employment", Label = new Dictionary { ["en"] = "Employment" }, }, new() { Value = "business", Label = new Dictionary { ["en"] = "Business" }, }, new() { Value = "investments", Label = new Dictionary { ["en"] = "Investments" }, }, new() { Value = "other", Label = new Dictionary { ["en"] = "Other" }, }, }, }, }, }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: SimpleQuestionnaireRequest: type: object description: >- Buat kuesioner linier sederhana. API mengonversi `form_elements` menjadi graf kuesioner internal. required: - title - languages - form_elements properties: title: type: string description: Nama internal untuk kuesioner. description: type: string nullable: true languages: type: array description: Bahasa yang disertakan dalam setiap label. Harus menyertakan `en`. items: type: string example: - en default_language: type: string description: Bahasa default. Harus disertakan dalam `languages`. example: en is_active: type: boolean default: true status: type: string enum: - draft - published description: >- Kosongkan kolom ini untuk membuat kuesioner yang dipublikasikan dan siap digunakan untuk alur kerja. form_elements: type: array minItems: 1 description: >- Pertanyaan dalam urutan tepat seperti yang harus dilihat pengguna. Percabangan dan kolom kondisional tidak didukung. items: $ref: '#/components/schemas/SimpleQuestionnaireElement' QuestionnaireDetail: type: object description: >- Detail kuesioner lengkap yang dikembalikan dari endpoint GET, POST (buat), dan PATCH (perbarui). properties: questionnaire_id: type: string format: uuid description: >- Pengenal unik kuesioner. Gunakan id ini saat mereferensikan kuesioner dari alur kerja atau dalam permintaan pembaruan/penghapusan berikutnya. title: type: string description: type: string nullable: true languages: type: array items: type: string default_language: type: string is_active: type: boolean is_simple_questionnaire: type: boolean graph: type: object description: Struktur graf dengan start_node dan peta node. sections: type: array description: >- Konten kuesioner yang dikelompokkan ke dalam bagian-bagian (berasal dari graf). items: type: object questionnaire_group_id: type: string format: uuid description: >- Pengidentifikasi stabil yang mengelompokkan semua versi dari kuesioner yang sama. version: type: integer status: type: string enum: - draft - published published_at: type: string format: date-time nullable: true is_editable: type: boolean description: >- True saat kuesioner masih dapat diedit langsung di tempat (versi draf). SimpleQuestionnaireElement: type: object required: - element_type - label properties: id: type: string description: >- ID pertanyaan stabil opsional. Jika diabaikan, API akan menghasilkan `q1`, `q2`, dll. Gunakan huruf kecil, angka, dan garis bawah demi keterbacaan. example: source_of_funds element_type: type: string description: >- Tipe pertanyaan. API menerima nilai huruf kecil ini beserta nilai huruf besar yang setara. enum: - short_text - long_text - dropdown - single_choice - multiple_choice - number - image - file_upload - time - email - address - phone - country - date_picker - consent - section_header - separator - heading - paragraph label: type: object description: >- Label pertanyaan berdasarkan kode bahasa, misalnya `{ "en": "Source of funds" }`. additionalProperties: type: string description: type: object nullable: true additionalProperties: type: string placeholder: type: object nullable: true additionalProperties: type: string is_required: type: boolean default: false options: type: array description: >- Gunakan untuk `dropdown`, `single_choice`, dan `multiple_choice`. Jika `value` dihilangkan, API akan membuatnya dari label opsi. items: type: object required: - label properties: value: type: string label: type: object additionalProperties: type: string max_files: type: integer minimum: 1 maximum: 5 description: Gunakan dengan `file_upload` atau `image`. validation: type: object nullable: true description: >- Validasi format opsional untuk `short_text`, `long_text`, atau `number`. Diberlakukan saat pengguna mengisi kolom (mereka tidak dapat melanjutkan hingga lolos) dan diperiksa ulang oleh API saat pengiriman. properties: pattern: type: string description: >- Ekspresi reguler (subset ECMA-262) yang harus dicocokkan sepenuhnya oleh nilai tersebut. Untuk `short_text` dan `long_text`. Jangan tambahkan jangkar ^/$; seluruh nilai akan dicocokkan. min_length: type: integer minimum: 0 description: Jumlah karakter minimum. Untuk `short_text` dan `long_text`. max_length: type: integer minimum: 0 description: Jumlah karakter maksimum. Untuk `short_text` dan `long_text`. min: type: number description: Nilai numerik minimum. Untuk `number`. max: type: number description: Nilai numerik maksimum. Untuk `number`. error_message: type: object description: >- Pesan terjemahan yang ditampilkan saat validasi gagal, diberi kunci berdasarkan kode bahasa. additionalProperties: type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.