> ## 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 de création de questionnaire KYC personnalisé > Créez des questionnaires KYC et de conformité personnalisés via API, avec questions ordonnées, options et 54 traductions. Facturation à l'appel avec Didit. Prompt de l'API pour créer un questionnaire Copier le prompt dans le presse-papiers \

\`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.`

\
Coller dans Utilisez cet endpoint pour créer des questionnaires simples via l'API. Envoyez un tableau `form_elements` dans l'ordre dans lequel les utilisateurs doivent répondre aux questions. Didit construit pour vous le graphe interne du questionnaire.L'API prend en charge uniquement les questionnaires linéaires simples. N'envoyez pas `graph`, `branches`, `next` ni de règles conditionnelles.## Champs obligatoires- `title` correspond au nom interne du questionnaire. - `languages` doit inclure `en`. - `form_elements` doit contenir au moins une question. - Chaque élément de formulaire nécessite un `element_type` et un `label` traduit.Vous pouvez également ajouter à un élément de formulaire une `description` traduite facultative, qui sert de texte d'aide. Elle est acceptée pour tous les types d'éléments, à l'exception de `separator`, et elle est renvoyée comme `description` de l'élément dans le [rapport du questionnaire](https://docs.didit.me/fr/core-technology/questionnaires/report-questionnaire.md).## Types d'élémentsUtilisez des valeurs en minuscules, comme `short_text`, `multiple_choice`, `email`, `file_upload` ou `date_picker`. Les valeurs d'énumération en majuscules, comme `SHORT_TEXT`, sont également acceptées.Pour `dropdown`, `single_choice` et `multiple_choice`, ajoutez `options`. Si vous omettez la `value` d'une option, Didit en génère une à partir du libellé.```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" } } ] } ] } ```## Validation des champsAjoutez un objet `validation` facultatif à un élément `short_text`, `long_text` ou `number` pour imposer un format à la réponse de l'utilisateur. Cela est utile pour les identifiants au format strict, comme les identifiants fiscaux, les numéros d'identité nationale ou les numéros de carte. La validation s'exécute pendant que l'utilisateur remplit le champ (il ne peut pas passer à l'étape suivante tant que la valeur n'est pas valide) et l'API la réapplique lors de la soumission.| Champ | S'applique à | Description | | - | - | - | | `pattern` | `short_text`, `long_text` | Expression régulière à laquelle la valeur doit correspondre entièrement. Utilisez le sous-ensemble portable d'ECMA-262 ; n'ajoutez pas d'ancres `^`/`$` (la valeur entière est comparée). | | `min_length` | `short_text`, `long_text` | Nombre minimal de caractères. | | `max_length` | `short_text`, `long_text` | Nombre maximal de caractères. | | `min` | `number` | Valeur numérique minimale. | | `max` | `number` | Valeur numérique maximale. | | `error_message` | Tous les éléments ci-dessus | Message traduit affiché lorsque la valeur n'est pas valide. Un message générique est utilisé si ce paramètre est omis. |```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)." } } } ] } ```La réponse contient `questionnaire_id`. Conservez-le, car vous l'utiliserez comme `questionnaire_uuid` lorsque vous ajouterez le questionnaire à un workflow. ## OpenAPI ````yaml fr/openapi-25.json POST /v3/questionnaires/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/questionnaires/: post: tags: - Questionnaires summary: Créer un questionnaire description: "Créez un questionnaire linéaire simple. Envoyez `form_elements` dans l'ordre d'affichage\_; les branchements et les groupes répétables nécessitent la Console. Défini par défaut sur `published` v1." operationId: create_questionnaire requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SimpleQuestionnaireRequest' examples: Simple: summary: Questionnaire de base 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: >- Questionnaire créé. La réponse inclut le `questionnaire_id` — conservez-le pour référencer ce questionnaire dans les workflows ou lors de futurs appels de mise à jour/suppression. 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: >- Erreur de validation. Causes courantes : un `element_type` inconnu, un champ traduisible sans traduction pour l'une des `languages`, `languages` ne contenant pas `en`, `default_language` absent de `languages`, une option sans `label`, une question comportant `branches`/`required_if`/`repeatable_config` (non pris en charge par cet endpoint), ou l'envoi d'un `graph` brut au lieu de `form_elements`. Le corps est une erreur de validation DRF indexée par nom de champ. 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: >- Clé API manquante, mal formée, expirée ou limitée à une application différente. content: application/json: examples: Invalid token: value: detail: You do not have permission to perform this action. '415': description: >- Type de média non pris en charge. Définissez `Content-Type: application/json` et envoyez un corps JSON. '429': description: >- Limite de débit dépassée. Réessayez avec une temporisation exponentielle. '500': description: >- Erreur serveur inattendue lors de la création du questionnaire. Peut être réessayé en toute sécurité. 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: >- Créez un questionnaire linéaire simple. L'API convertit `form_elements` en graphe interne du questionnaire. required: - title - languages - form_elements properties: title: type: string description: Nom interne du questionnaire. description: type: string nullable: true languages: type: array description: Langues incluses dans chaque libellé. Doit inclure `en`. items: type: string example: - en default_language: type: string description: Langue par défaut. Doit être incluse dans `languages`. example: en is_active: type: boolean default: true status: type: string enum: - draft - published description: >- Omettez ce champ pour créer un questionnaire publié et prêt pour les workflows. form_elements: type: array minItems: 1 description: >- Questions dans l'ordre exact où les utilisateurs doivent les voir. Les embranchements et les champs conditionnels ne sont pas pris en charge. items: $ref: '#/components/schemas/SimpleQuestionnaireElement' QuestionnaireDetail: type: object description: >- Détails complets du questionnaire renvoyés par les endpoints GET, POST (création) et PATCH (mise à jour). properties: questionnaire_id: type: string format: uuid description: >- Identifiant unique du questionnaire. Utilisez cet identifiant pour faire référence au questionnaire depuis un workflow ou lors de requêtes ultérieures de mise à jour ou de suppression. 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: >- Structure en graphe avec start_node et la table de correspondance des nœuds. sections: type: array description: Contenu du questionnaire regroupé en sections (dérivé du graphe). items: type: object questionnaire_group_id: type: string format: uuid description: >- Identifiant stable qui regroupe toutes les versions du même questionnaire. version: type: integer status: type: string enum: - draft - published published_at: type: string format: date-time nullable: true is_editable: type: boolean description: >- Vrai lorsque le questionnaire peut encore être modifié directement (versions brouillon). SimpleQuestionnaireElement: type: object required: - element_type - label properties: id: type: string description: >- Identifiant de question stable optionnel. S'il est omis, l'API génère `q1`, `q2`, etc. Utilisez des lettres minuscules, des chiffres et des traits de soulignement pour une meilleure lisibilité. example: source_of_funds element_type: type: string description: >- Type de question. L'API accepte ces valeurs en minuscules ainsi que leurs équivalents en majuscules. 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: >- Libellé de la question par code de langue, par exemple `{ "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: >- À utiliser pour `dropdown`, `single_choice` et `multiple_choice`. Si `value` est omis, l'API en génère un à partir du libellé de l'option. items: type: object required: - label properties: value: type: string label: type: object additionalProperties: type: string max_files: type: integer minimum: 1 maximum: 5 description: À utiliser avec `file_upload` ou `image`. validation: type: object nullable: true description: >- Validation de format optionnelle pour `short_text`, `long_text` ou `number`. Appliquée pendant que l'utilisateur remplit le champ (il ne peut pas continuer tant qu'elle n'est pas validée) et vérifiée de nouveau par l'API lors de l'envoi. properties: pattern: type: string description: >- Expression régulière (sous-ensemble ECMA-262) à laquelle la valeur doit correspondre entièrement. Pour `short_text` et `long_text`. N'ajoutez pas d'ancres ^/$ ; la valeur entière est mise en correspondance. min_length: type: integer minimum: 0 description: Nombre minimum de caractères. Pour `short_text` et `long_text`. max_length: type: integer minimum: 0 description: Nombre maximal de caractères. Pour `short_text` et `long_text`. min: type: number description: Valeur numérique minimale. Pour `number`. max: type: number description: Valeur numérique maximale. Pour `number`. error_message: type: object description: >- Message traduit affiché en cas d'échec de validation, indexé par code de langue. additionalProperties: type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.