Passing request parameters in the integration builder for AI agents

<div class="article-banners">
<div id="docs-wmp-link"><a href="https://support.zendesk.com/hc/en-us/articles/5411234991258-plan" rel="noopener noreferrer" target="_blank">What's my plan?</a></div>
<div class="article-banner" id="suite_all"><figure class="wysiwyg-table wysiwyg-table-align-left"><table><tbody><tr>
<td><strong>All Suites</strong></td>
<td>Team, Growth, Professional, Enterprise, or Enterprise Plus</td>
</tr></tbody></table></figure></div>
<div class="article-banner" id="support_all"><figure class="wysiwyg-table wysiwyg-table-align-left"><table><tbody><tr>
<td><strong>Support</strong></td>
<td>Team, Professional, or Enterprise</td>
</tr></tbody></table></figure></div>
</div><div class="body">

<p>When using the integration builder, you can pass request parameters of types such as string, number, boolean, and array in the API request body. This functionality enables greater flexibility in API integrations and supports a wider range of use cases. In this article, we’ll guide you through the process of configuring these parameters.</p>
<p>This article contains the following topics:</p>
<ul>
<li data-list-item-id="e208344347b81e3b355533fa88ec5b31e"><a href="#h_01JMFSFD7HTNAJSAQQBZ32J530">Setting the parameter type in request parameters</a></li>
<li data-list-item-id="efb28688332970f10ffc675f3aee8f1d0"><a href="#h_01JMFSNQFER294SX67CRCYDVV2">Add reformatting for array parameters</a></li>
<li data-list-item-id="e3ac99d8391535493b943d49f62ae2f0f"><a href="#h_01JMFSFD7HYFD25W9231DYC5BP">Using parameters in the API call request body</a></li>
<li data-list-item-id="e94112c6f250b72b829e8f10b89fe5b03"><a href="#h_01JMFSFD7H1M3HP51E4Q3M5KR1">Testing your configuration</a></li>
</ul>
<p>Related articles:</p>
<ul><li data-list-item-id="e4e017ff10942326c6ffc66362834e8cf"><a href="https://support.zendesk.com/hc/en-us/articles/8498753675290">Integration builder resources</a></li></ul>
<h2 id="h_01JMFSFD7HTNAJSAQQBZ32J530">Setting the parameter type in request parameters</h2>
<p><strong>To set the parameter type in request parameters</strong></p>
<ol>
<li data-list-item-id="ef2e47a6ee65bfe29a7d1864a06dd98cc">Navigate to the <strong>Request Parameters</strong> section in the integration builder.</li>
<li data-list-item-id="e9bc1b59b72d95b85b60cb1bdd2f9a19f">Define your parameter and set its type as one of the following:<ul>
<li data-list-item-id="e00a843a8395352e8c6757be1c5364e07">
<strong>String</strong>: For textual data enclosed in quotes (for example, "example text").</li>
<li data-list-item-id="e7ac95042120e7df3289046db327dc2c3">
<strong>Number</strong>: For numerical values (for example, 123).</li>
<li data-list-item-id="e960b9f275c0d255431673b28a428b3b5">
<strong>Boolean</strong>: For true/false values.</li>
<li data-list-item-id="e5f575b6a34253aa2616f85ce00856a44">
<strong>Array</strong>: For a collection of values (for example, ["item1", "item2"]).<br><img src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/aiaa_pass_params_1.png" width="600">
</li>
</ul>
</li>
</ol>
<h2 id="h_01JMFSNQFER294SX67CRCYDVV2">Add reformatting for array parameters</h2>
<p>For testing purposes in the integration builder with parameters of type array, you must add a reformatting function to ensure proper handling of the data type. To do so, use the following function:</p>
<p>$eval($)</p>
<p>This function parses the string value into an array object.</p>
<p>If the parameter is already an array object, the function will not alter its behavior.</p>
<p><img src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/aiaa_pass_params_2.png" width="600"></p>
<p>For more information, see <a href="https://support.zendesk.com/hc/en-us/articles/8560203369242">Reformatting values in request parameters for AI agents</a>.</p>
<h2 id="h_01JMFSFD7HYFD25W9231DYC5BP">Using parameters in the API call request body</h2>
<p>In the API call request body, these parameters can be used in the same format as string parameters, using the syntax: {{&lt;REQUEST_PARAMETER&gt;}}</p>
<p>While the parameter may visually appear as a string in the body—as you can see in the screenshot below—during execution it will transform into the corresponding data type specified in the Request Parameters section.</p>
<p><img src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/aiaa_pass_params_3.png" width="600"></p>
<h2 id="h_01JMFSFD7H1M3HP51E4Q3M5KR1">Testing your configuration</h2>
<p>Use the Test Production button in the integration builder to execute your API call.</p>
<p>Verify that the parameters are being passed with the correct types (string, number, boolean, array) in the request.</p>
<p>Review the response to ensure proper handling by the API.</p>
<div class="note">
<span class="notetitle">Note:</span> Successful transformations depend on correctly setting up parameter types and reformatting functions. Misconfiguration may lead to errors in API calls.</div>
<p> </p>
<script id="docs-schema-markup" type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": "https://support.zendesk.com/hc/en-us/articles/8920235767834",
"url": "https://support.zendesk.com/hc/en-us/articles/8920235767834-Passing-request-parameters-in-the-integration-builder-for-advanced-AI-agents",
"headline": "Passing request parameters in the integration builder for advanced AI agents",
"description": "You can configure and test request parameters of various types in the integration builder to ensure they are correctly passed and handled in API call request bodies for advanced AI agents.",
"articleSection": "Integrating other platforms with advanced AI agents",
"datePublished": "2025-02-19T19:04:03+00:00",
"dateModified": "2025-09-05T23:12:37+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/8920235767834"
},
"author": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"publisher": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"isPartOf": {
"@type": "WebSite",
"name": "Zendesk Help",
"@id": "https://support.zendesk.com/hc/"
},
"about": {
"@type": "SoftwareApplication",
"name": "Zendesk",
"@id": "https://www.zendesk.com",
"softwareAddOn": {
"@type": "SoftwareApplication",
"name": "AI agents",
"@id": "https://support.zendesk.com/hc/en-us/sections/8988994355994"
}
}
}
</script>
</div>