What are custom actions?

Custom actions in Synthflow AI allow you to extend your Assistant’s capabilities by integrating external APIs.

Whether pulling in live information, creating new records, or adjusting conversational flow based on external inputs, custom actions make your Assistant more capable.

What can custom actions do?

• Connect to APIs

Make GET or POST requests to fetch or send data.

• Use dynamic variables

Insert user-specific data before or during the call.

• Automate workflows

Create, update, or retrieve external data automatically.

• Make conversations better

Use API responses to generate context-aware AI interactions.

GET vs. POST requests in custom actions

Custom actions can be configured with different HTTP methods based on the type of request:

• GET requests

Use GET requests to retrieve data from an API. The Assistant can pull in information, such as user details or order statuses, based on provided identifiers.

• POST requests

Use POST requests to create new resources. This could include logging call details, adding a new user to a database, or scheduling an appointment. POST requests require a structured output schema to organize the information the Assistant sends.

How custom actions work

1. Define the API call.

Choose the method (GET or POST), add the API endpoint, and configure authentication if required.

2. Set up variables.

Create placeholders for user data, define descriptions to guide the AI, and specify data types.

3. Configure structured output (for POST requests).

Ensure the Assistant sends correctly formatted data to the API.

4. Use the API response in conversations.

Write prompts to guide how the Assistant proceeds with the data.

Why use custom actions?

Synthflow AI’s custom actions let your Assistant pull in real-time data, trigger external actions, and automate tasks, so it can do more without extra manual work.

By integrating with other services, it can adjust responses based on API results, making interactions feel more natural and personalized. This keeps workflows running smoothly and helps your Assistant stay useful and relevant.