Create a new, empty section in an experiment

Use the order property to specify the position of the new section within the experiment. This is a 0-based integer where 0 is the top position within the experiment. If you omit this property the section is appended at the bottom.

CUSTOM Section Type

When creating a section from a type that is defined in an add-on, you can use the CUSTOM section type. An example of this is the Office Online Server add-on which provides the MSExcel, MSWord and MSPowerPoint section types. When creating a section with sectionType set to CUSTOM, you must also provide the customSectionData object with the following properties:

  • customSectionTypeName: The type name for the custom section (e.g., MSExcel, MSWord, MSPowerPoint)
  • rootVar: The root variable of the add-on that provides this section type (e.g., BIT_OOS_SUITE)
  • name: The display name for the section (e.g., Office Online Server)

The add-on specified by rootVar must be installed and active for your account. The add-on version is automatically retrieved.

Example: Create OOS Excel Section

{
    "sectionType": "CUSTOM",
    "sectionHeader": "My Excel Sheet",
    "customSectionData": {
        "customSectionTypeName": "MSExcel",
        "rootVar": "BIT_OOS_SUITE",
        "name": "Office Online Server"
    }
}

Example: Create OOS Word Section

{
    "sectionType": "CUSTOM",
    "sectionHeader": "My Word Document",
    "customSectionData": {
        "customSectionTypeName": "MSWord",
        "rootVar": "BIT_OOS_SUITE",
        "name": "Office Online Server"
    }
}

Example: Create OOS PowerPoint Section

{
    "sectionType": "CUSTOM",
    "sectionHeader": "My Presentation",
    "customSectionData": {
        "customSectionTypeName": "MSPowerPoint",
        "rootVar": "BIT_OOS_SUITE",
        "name": "Office Online Server"
    }
}

Example: Create Custom Add-on Section

{
    "sectionType": "CUSTOM",
    "sectionHeader": "My Custom Section",
    "customSectionData": {
        "customSectionTypeName": "MyCustomType",
        "rootVar": "MY_ADDON_ROOTVAR",
        "name": "My Custom Add-on"
    }
}
Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!