Functions

Navigate to Functions

From your YourGPT dashboard, navigate to Automation > Functions in the left sidebar. You'll see four types of functions available:

• System Functions - Pre-built system function templates
• Code Functions - Custom code execution functions
• API Functions - External API integrations
• MCP Servers - Model Context Protocol servers to enable your YourGPT AI Agent to call external tools and services.

Navigate to Code Functions

Select Code Functions from the dropdown menu and click the Add New Function button.

Configure Function Details

Fill in the basic information for your code function:

• Name: Enter a function name using only lowercase letters, numbers, underscores, and hyphens (e.g., create_post, update_todo)
• Description: Provide a clear description of what the function does
• Language: Select either JavaScript or Python
• Code: Write your custom code in the syntax-highlighted editor

Define Parameters

Add parameters that your function needs to execute:

1. Click Add Parameter to create a new parameter
2. For each parameter, specify:
   • Parameter name: The variable name (e.g., title, body, post_id)
   • Type: Select from string, number, boolean, etc.
   • Description: Explain what this parameter is for

The Generated Schema panel on the right automatically updates as you add parameters, showing the JSON schema in real-time.

Accessing Parameters in Code

Inside your code block, access the values the AI extracts from the user's message using TOOL_PARAMS.parameter_name (no curly braces — this is a JavaScript/Python variable, not a template placeholder):

const postId = TOOL_PARAMS.post_id;
const title = TOOL_PARAMS.title;

const url = `https://jsonplaceholder.typicode.com/posts/${postId}`;
const response = await fetch(url);
return await response.json();

Import Sample Code (Optional)

Click the Import Sample button to load pre-built examples:

• Create Blog Posts: HTTP POST request to create blog posts with title and body parameters
• Update Todo Items: PATCH request to update todo items with dynamic URLs and status management

Review and Save

Review your function configuration, including all parameters and the generated schema. The code editor shows your complete function with line numbers and syntax highlighting.

Click Add Function to save your code function.

Navigate to API Functions

Select API Functions from the dropdown menu and click the Add API Function button.

Configure API Details

Fill in the basic information for your API function:

• Name: Enter a descriptive name for your API function
• Description: Provide a brief explanation of what the function does
• API Endpoint:
  • Select the HTTP method (GET, POST, PATCH, PUT, DELETE, etc.)
  • Enter the endpoint URL for the API you want to call
  • Click Test API to verify the endpoint works

Add Headers and Request Parameters

• Headers: Add required headers (e.g., Authorization, Content-Type) using the + button.
• Request Parameters: Use the Key Value tab for simple pairs or Raw JSON tab for structured body data.
  • Key Value: city → {{TOOL_PARAMS.city}}
  • Raw JSON: {"city": "{{TOOL_PARAMS.city}}", "unit": "metric"}
• AI Parameters (JSON): Define what the AI should extract from the user — name, type, and description for each parameter. The Generated Schema panel updates automatically.

Using Parameters in Your Request

Use {{TOOL_PARAMS.parameter_name}} anywhere in your request — the AI fills in the value from the user's message at runtime.

Import Sample API (Optional)

Click the Import Sample button to load pre-configured API examples:

• Products API: GET request to fetch products with limit, skip, and select parameters
• Recipe API: Additional sample API configurations

Alternatively, use Import from cURL to convert cURL commands directly into function configuration.

Review and Save

Review your complete API function configuration, including all parameters and the generated schema. Verify that:

• All required parameters are defined
• The API endpoint is correct
• Headers are properly configured

Click Add API Function to save your configuration.