Documentation Center

Get a Marketo form

Use the externalItem GraphQL query get a single Marketo form. This example request illustrates a request to retrieve form data (MarketoForm as the entity type) based on a form's ECL URI.

Example request

{
externalItem(
  eclUri: "ecl:2-mkt-1816-MarketoForm-file"
  ) {
    ... on MarketoForm {
      identity {
        id
        localeId
        namespace
        structureType
      }
      parentIdentity {
        id
        localeId
        namespace
      }
      description
      status
      theme
      locale
      progressiveProfiling
      labelPosition
      fontFamily
      fontSize
      buttonLocation
      buttonLabel
      waitingLabel
      createdAt
      lastModifiedAt
      externalUrl
      fields {
        id,
        label,
        dataType,
        validationMessage,
        rowNumber,
        columnNumber,
        maxLength,
        required,
        formPrefill
      }
    }
  }
}

Example response

{
    "data": {
        "externalItem": {
            "identity": {
                "id": "1816",
                "localeId": "2",
                "namespace": "mkt",
                "structureType": "Leaf"
            },
            "parentIdentity": null,
            "description": "Simple Register Form",
            "status": "approved",
            "theme": "round",
            "locale": "en_US",
            "progressiveProfiling": true,
            "labelPosition": "left",
            "fontFamily": "Helvetica",
            "fontSize": "13px",
            "buttonLocation": 120,
            "buttonLabel": "Register",
            "waitingLabel": "Please Wait",
            "createdAt": "2021-06-17T15:08:36Z",
            "lastModifiedAt": "2022-03-16T13:57:56Z",
            "externalUrl": "https://app-sjl.marketo.com/#FO1816A1ZN13LA1",
            "fields": [
                {
                    "id": "FirstName",
                    "label": "FirstName",
                    "dataType": "text",
                    "validationMessage": "This field is required.",
                    "rowNumber": 0,
                    "columnNumber": 0,
                    "maxLength": 255,
                    "required": true,
                    "formPrefill": true
                },
                {
                    "id": "LastName",
                    "label": "Last Name:",
                    "dataType": "text",
                    "validationMessage": "This field is required.",
                    "rowNumber": 1,
                    "columnNumber": 0,
                    "maxLength": 255,
                    "required": true,
                    "formPrefill": true
                },
                {
                    "id": "Email",
                    "label": "Email Address:",
                    "dataType": "email",
                    "validationMessage": "Must be valid email. <span class='mktoErrorDetail'>example@yourdomain.com</span>",
                    "rowNumber": 2,
                    "columnNumber": 0,
                    "maxLength": 0,
                    "required": true,
                    "formPrefill": true
                },
                {
                    "id": "Profiling",
                    "label": null,
                    "dataType": "profiling",
                    "validationMessage": null,
                    "rowNumber": 3,
                    "columnNumber": 0,
                    "maxLength": 0,
                    "required": false,
                    "formPrefill": false
                }
            ]
        }
    }
}