From your request
to a tool’s result.

Invoke Heelo tools from your application and work with their returned results.

1curl "$HEELO_API_URL/v1/tools/google.calendar_create_event/invoke" \
2  -H "Authorization: Bearer $HEELO_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5  "input": {
6    "query": "Create a 30-minute Product launch review on October 15, 2026 at 10am in my calendar timezone."
7  }
8}'

Set your deployment URL and API key. Connect Google Calendar before running this example.

HTTP API, in practice.

Direct tool invocation

POST /v1/tools/{tool_id}/invoke accepts the tool’s structured input when your application already knows the action.

Inspect the tool schema

Choose a registered tool and use its published input fields, connection requirements and examples to build your request.

Handle every response

Inspect tool results, follow-up requests and authorization needs. A successful HTTP response alone is not proof that a whole business task finished.

POST /v1/tools/{tool_id}/invoke

Use the tool’s published input schema for a direct call. Inspect returned results and handle any request for account authorization or additional information in your application.

← Explore developers See what you can do ↗