AI Apply

Inquire about a job posting's current form

Changed on

Receive the application form (screening questions) for a job posting and a single-use submission JWT. Store the token with the exact application form returned alongside it. The submission token is valid for 2 days and can be used for one application. The application form may contain conditional questions that are only shown based on answers to previous questions (check the display_when field).

post/ai-apply/postings/{posting_id}/inquire

Request

  • Base URL
    https://api.kombo.dev/v1
  • Auth
    HTTP bearer

Path parameters

posting_idstring required

The globally unique ID of this object generated by Kombo. We recommend using this as a stable primary key for syncing.

Request body

PostAiApplyPostingsPostingIdInquireRequestBody required

Response

POST /ai-apply/postings/:posting_id/inquire Positive response

status'success' required

Example response

{
  "data": {
    "application_form": [
      {
        "block_type": "SECTION",
        "label": "Personal Information",
        "children": [
          {
            "block_type": "QUESTION",
            "question_id": "6VrjehyBk685vubNydiR1hSn",
            "label": "First name",
            "description": null,
            "required": true,
            "category": null,
            "question_type": "TEXT",
            "unified_key": "FIRST_NAME",
            "options": null,
            "display_when": null
          },
          {
            "block_type": "QUESTION",
            "question_id": "Hjsapofs69cx2iAu6MtTfhoh",
            "label": "Last name",
            "description": null,
            "required": true,
            "category": null,
            "question_type": "TEXT",
            "unified_key": "LAST_NAME",
            "options": null,
            "display_when": null
          },
          {
            "block_type": "INFORMATION",
            "category": null,
            "text": "We will use this information to contact you about your application.",
            "display_when": null
          }
        ]
      },
      {
        "block_type": "QUESTION",
        "question_id": "EKaumKPGjeA97cb8ystMmkCe",
        "label": "What is your desired working location?",
        "description": "Select your preferred work arrangement",
        "required": true,
        "category": null,
        "question_type": "SINGLE_SELECT",
        "unified_key": null,
        "options": [
          {
            "id": "BsnL4pAhNQc26uSc4JopTP3P",
            "label": "Remote",
            "unified_key": null
          },
          {
            "id": "8T4fcKgzLxbKFUo4saXaoMTG",
            "label": "On-site",
            "unified_key": null
          },
          {
            "id": "2cJDK3dq4WNjovohSG7dSpfd",
            "label": "Hybrid",
            "unified_key": null
          }
        ],
        "display_when": null
      },
      {
        "block_type": "QUESTION",
        "question_id": "2H26BKTbDn2ygN2GfEcCsUP8",
        "label": "What timezone are you in?",
        "description": "This helps us schedule meetings at convenient times",
        "required": true,
        "category": null,
        "question_type": "TEXT",
        "unified_key": null,
        "options": null,
        "display_when": {
          "question_id": "EKaumKPGjeA97cb8ystMmkCe",
          "answer_equals": "BsnL4pAhNQc26uSc4JopTP3P"
        }
      },
      {
        "block_type": "INFORMATION",
        "category": null,
        "text": "Remote applicants should include their timezone so we can schedule interviews.",
        "display_when": {
          "question_id": "EKaumKPGjeA97cb8ystMmkCe",
          "answer_equals": "BsnL4pAhNQc26uSc4JopTP3P"
        }
      },
      {
        "block_type": "QUESTION",
        "question_id": "AdM1EuwBKE4pz94SSRHMgmba",
        "label": "Which office would you prefer?",
        "description": null,
        "required": true,
        "category": null,
        "question_type": "SINGLE_SELECT",
        "unified_key": null,
        "options": [
          {
            "id": "EHCqUb5E6xzfjnfHT2LEgmM7",
            "label": "San Francisco",
            "unified_key": null
          },
          {
            "id": "5RbHT73StFM5tHdF3aVr4do1",
            "label": "New York",
            "unified_key": null
          },
          {
            "id": "F4rRwGTNeLQZV5VLwstERpsT",
            "label": "London",
            "unified_key": null
          }
        ],
        "display_when": {
          "question_id": "EKaumKPGjeA97cb8ystMmkCe",
          "answer_equals": "8T4fcKgzLxbKFUo4saXaoMTG"
        }
      },
      {
        "block_type": "QUESTION",
        "question_id": "FuVZvF26NueKcN46o5euHeGx",
        "label": "How many days per week would you like to work in the office?",
        "description": null,
        "required": true,
        "category": null,
        "question_type": "NUMBER",
        "unified_key": null,
        "options": null,
        "display_when": {
          "question_id": "EKaumKPGjeA97cb8ystMmkCe",
          "answer_equals": "2cJDK3dq4WNjovohSG7dSpfd"
        }
      }
    ],
    "requires_proxy_email": true,
    "submission_token": "<example-token>"
  }
}

Changes

    • info

      added the required property / to the response with the status

    • warning

      added the new RESIDENCE_HOUSE_NUMBER enum value to the //// response property for the response status

    • warning

      added the new RESIDENCE_STREET_NAME enum value to the //// response property for the response status