---
sourceDocument: Australia Security Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/security-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Security Management

ft:clusterId :

    - security

bundleId :

    - security

workflow :

    - Technology


---

# Provide input values

# Provide input values for your API connector {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Provide input parameters to make a valid API call, test the connection, and receive a sample response.

## Before you begin

For all templates, you can select the information icon () to learn more about each parameter. You can use the API samples provided with each template. After you define your input parameters, you must test your connection.

You have the option to get guidance for selecting a template with a Now Assist skill for this step. See [Using generative AI skills](https://servicenow-prod.fluidtopics.net/C3UyNwI8tNIr20OwbCnrcA "AI skills help vulnerability managers and analysts resolve remediation tasks within their flow of work by providing automated insights, recommendations, and data analysis.") for more information about the generative AI skill and [Creating an API connector with generative AI](https://servicenow-prod.fluidtopics.net/Vl~1MdcnBb7cTQgdFb8t7g "Developers can use the SPC Setup Connector generative AI skill to help them quickly and automatically create an API connector that they can publish. Use the connector in the Security Posture Control workspace.") about using the skill in connector framework.

Roles required:

* sn_sec_spc_core.developer
* sn_spc_cxf.admin - required for advanced scripting
{#spc-sgc-template-stepper-4__ul_r1y_ht1_lgc}

## Procedure

1. Fill in the fields.  
   Note:  
   If you change any input parameters after testing the connection, you must test the connection again before you can continue on to [Map API response to SPC attributes](https://servicenow-prod.fluidtopics.net/4IX24kq~UCA1D9ardYMUcg "Map API response properties to SPC attributes. After you have mapped the attributes, you publish your connector so it imports data.").
   {#spc-sgc-template-stepper-4__table_j1c_st4_sfc__entry__3}

   | Field | Description | Example |
   |-|-|-|
   | Object list path | Path to the list of assets in the response payload. | An example: <kbd class="ph userinput">$.list</kbd> |
   | API endpoint relative path | This is the path to the API without the host URL. | An example: <kbd class="ph userinput">/r2</kbd> |
   | API query parameters | Key-value pairs that are appended to the API URL for filtering. Values can be strings, scripts, or references to fields in the credential table. | An example: Name \[name of query parameter\] Value type \[Static values\] Value \[a string\] |
   | Pagination parameters | Dynamic parameters used to retrieve subsequent pages of API data. Specify the parameter name, its location in the request (Query, Header, or Body), the path to extract its next value from the API response, and an optional default value. | An example of pagination type Offset: Offset Parameter name \[start\] Location in API request \[Query parameters\] Default value \[0\] Limit Parameter name \[count\] Location in API request \[Query parameters\] Default value \[5\] |
   | (Optional) Add parameter | Add custom parameters | Select Add parameter to define your own parameters. For example, you might want to determine if there are additional pages of data that are included in the API response. Parameter name \[hasMore\] Path in API response \[$.hasMore\] Location in API request \[Header parameters\] Default value \[1\] |
   [ ]

   {#spc-sgc-template-stepper-4__table_j1c_st4_sfc}
2. When you're satisfied with your API input, select Get sample response.  
   After a few moments, a message is displayed if the connection was successful.

   If you entered your parameters manually for this step, the data imported from the connection test that is rendered in the sample
   response is authentic and you can use it in the next step to help you map parameters.
3. Select Save and continue to save your edits.  
   You must save your changes before you can continue.