Insites Docs Instance APICustom API EndpointsCreating a Custom API Endpoint

Creating a Custom API Endpoint

Last updated on April 09, 2026.

Creating a Custom API Endpoint defines a URL path on your Instance that external systems can call to send or retrieve data. Each endpoint maps to a Liquid file that handles the request and shapes the response. The create form is a two-step wizard: fill out the Details tab, then write the endpoint content in the Body tab.

  1. Navigate to API from the main menu.
  2. Select Custom API Endpoints.
  3. Select CREATE API ENDPOINT.
  4. Fill out the Details tab (explained below). Select NEXT to continue.
  5. Write the endpoint content in the Body tab.
  6. Select CREATE CUSTOM API ENDPOINT to save.

Details

The Details tab captures the core configuration for the endpoint: what it is called, where it lives in the file system, how it accepts requests, and which Authorization Policies protect it.

Input LabelTypeRequiredDescription
Custom API Endpoint NameTextYesA display name for the endpoint. Used to identify it in the list view.
SlugTextYesThe URL path for the endpoint. A preview shows the full URL: https:///.json
File PathText with folder pickerYesThe file location for the endpoint logic. Use the folder picker to select the correct module path.
Request MethodDropdownYesThe HTTP method this endpoint responds to. Options: GET, POST, PUT, PATCH, DELETE. Defaults to GET.
Authorization PoliciesMulti-select dropdownNoOne or more Authorization Policies to protect this endpoint. Only policies that already exist on the Instance appear here.
Redirect toTextNoA URL to redirect API users to.
Redirect CodeDropdownNoThe redirect type. Options: 301 (Moved Permanently) or 302 (Moved Temporarily).

Body

The Body tab contains the Liquid code that runs when the endpoint receives a request. This is where you define what data is fetched, processed, and returned. Press F10 to enter fullscreen mode in the editor.

Input LabelTypeRequiredDescription
BodyCode editorYesThe Liquid content that powers the endpoint response. The output of this template is returned to the caller.
Have a suggestion for this page?

Didn't quite find what you are looking for or have feedback on how we can make the content better then we would love to hear from you. Please provide us feedback and we will get back to you shortly.