BookedIn

Interact with BookedIn AI agents, leads, campaigns, strategies, lists, and human messaging

Actions29

Overview

This node integrates with the BookedIn AI platform to manage AI agents and related entities such as leads, lists, strategies, campaigns, and human messaging. Specifically, for the Agent - Create operation, it allows users to create a new AI agent by specifying its name, objective, personality prompt, and model configuration.

Use cases include automating tasks like booking meetings, managing customer interactions, or any scenario where an AI assistant with a defined goal and personality is needed. For example, you could create an agent whose objective is to schedule sales calls automatically, providing it with a custom prompt that defines its behavior and tone.

Properties

Name	Meaning
Agent Name	A human-readable name for your agent.
Objective	The main objective or goal of the agent (e.g., "Book meetings for our sales team").
Agent Prompt	Core instructions and personality traits for the AI agent, defining how it should behave.
Model	AI model to use for the agent. Options: GPT-4o, GPT-4.1
Webhook URL	Optional URL to which the agent will send event notifications.
Update Lead Fields	Boolean flag indicating whether the agent should update lead fields during its operations.

Output

The node outputs JSON data representing the created agent object returned from the BookedIn API. This typically includes the agent's ID, name, configuration details (objective, prompt, model), and other metadata. There is no binary output for this operation.

Example output JSON structure (simplified):

{
  "id": "ag_1234567890",
  "name": "My Agent",
  "agent_config": {
    "objective": "Book meetings for our sales team",
    "prompt": "You are a helpful AI assistant...",
    "model": "openai/gpt-4o",
    "update_lead_fields": true,
    "webhook_url": "https://example.com/webhook"
  },
  "created_at": "2024-01-01T12:00:00Z",
  "updated_at": "2024-01-01T12:00:00Z"
}

Dependencies

Requires an API key credential for authenticating with the BookedIn API.
The node makes HTTP requests to https://api.bookedin.ai/api/v1/agents/.
No additional environment variables are explicitly required beyond the API authentication setup in n8n.

Troubleshooting

Invalid or missing required fields: Ensure all required properties (Agent Name, Objective, Agent Prompt) are provided and non-empty.
API authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
Webhook URL issues: If using a webhook URL, ensure it is reachable and properly handles incoming events.
Model selection: Use one of the supported models (GPT-4o or GPT-4.1). Using unsupported values may cause errors.
Network errors: Check network connectivity and firewall settings if requests to the BookedIn API fail.

Common error messages:

"Phone number must be in international format starting with +" — Not applicable here but seen in other operations; ensure phone numbers are formatted correctly if used.
"Invalid JSON format" — Relevant if JSON inputs are malformed; not applicable for this operation since inputs are strings and options.
"At least one field must be provided" — Not relevant for create operation but important for update operations.

Links and References

BookedIn API Documentation (general reference for API endpoints)
OpenAI Models (for understanding GPT-4o and GPT-4.1 models)

This summary focuses on the Agent - Create operation as requested, describing its purpose, inputs, outputs, dependencies, and common troubleshooting tips based on static code analysis.

BookedInInstall