Etermin | Composio Docs

Overview

SLUG: ETERMIN

Description

eTermin is an online appointment scheduling platform that allows businesses to manage bookings and integrate with various applications through its REST API.

Authentication Details

API Key

bearer_token

stringRequired

generic_api_key

stringRequired

generic_secret

stringRequired

generic_id

stringRequired

Connecting to Etermin

Create an auth config

Use the dashboard to create an auth config for the Etermin toolkit. This allows you to connect multiple Etermin accounts to Composio for agents to use.

Select App

Navigate to Etermin.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Etermin Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 etermin_auth_config_id = "ac_YOUR_ETERMIN_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Etermin for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, etermin_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Etermin toolkit’s playground

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["ETERMIN"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

ETERMIN_CREATE_CONTACT

Tool Name: Create Contact

Description

Tool to create a new contact in eTermin. Use when you need to add a contact before scheduling appointments.

Action Parameters

stringRequired

firstname

stringRequired

lastname

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_CREATE_RESOURCE

Tool Name: Create eTermin Resource

Description

Tool to create a new resource. Use when you need to create any eTermin resource (contact, vouchers, resource, appointment).

Action Parameters

data

objectRequired

resource

stringRequired

use_form_encoding

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_CREATE_USER

Tool Name: Create User

Description

Tool to create a new user. Use when you need to add users to eTermin after collecting their details.

Action Parameters

stringRequired

first_name

stringRequired

last_name

stringRequired

locale

string

password

stringRequired

phone

string

role

stringDefaults to client

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_CREATE_VOUCHER

Tool Name: Create Voucher

Description

Tool to create a new voucher in eTermin. Use when you need to add a voucher after defining its details.

Action Parameters

code

stringRequired

discount

numberRequired

type

stringRequired

valid_from

stringRequired

valid_to

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_CREATE_WEBHOOK

Tool Name: Create Webhook

Description

Tool to create a new webhook in eTermin. Attempts multiple candidate endpoints since webhook creation is undocumented. Returns a helpful message if UI-only.

Action Parameters

data

object

use_form_encoding

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_DELETE_APPOINTMENT

Tool Name: Delete Appointment

Description

Tool to delete an appointment. Use when you need to remove an existing appointment by its identifier. Confirm the appointment exists before invoking.

Action Parameters

appointmentId

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_DELETE_CALENDAR

Tool Name: Delete calendar

Description

Tool to delete a calendar. Use when removing an existing calendar by its identifier.

Action Parameters

calendarId

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_DELETE_CONTACT

Tool Name: Delete Contact

Description

Tool to delete a contact. Use when you need to remove a contact by its ID after confirming it exists.

Action Parameters

contact_id

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_DELETE_RESOURCE

Tool Name: Delete Resource

Description

Tool to delete an existing resource. Uses multiple endpoint/method variants to account for eTermin API differences across resources.

Action Parameters

resource

stringRequired

resourceId

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_DELETE_SERVICE

Tool Name: Delete Service

Description

Tool to delete a service. Use when you need to remove a service by its ID after confirming deletion.

Action Parameters

service_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_DELETE_USER

Tool Name: Delete User

Description

Tool to delete a user. Use when you need to remove an existing user by its identifier. Confirm the user exists before invoking.

Action Parameters

userId

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_DELETE_VOUCHER

Tool Name: Delete Voucher

Description

Tool to delete an existing voucher. Use after confirming the voucher ID is correct.

Action Parameters

voucherId

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_DELETE_WEBHOOK

Tool Name: Delete Webhook

Description

Tool to delete an existing webhook. Use when you need to remove a webhook subscription by its ID after confirming it exists.

Action Parameters

webhookId

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_GET_APPOINTMENTS

Tool Name: Get Appointments

Description

Tool to retrieve a list of appointments. Use when you need to list all scheduled appointments.

Action Parameters

limit

integer

offset

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_GET_CALENDARS

Tool Name: Get Calendars

Description

Tool to retrieve calendars. Use when listing all calendars in your eTermin account.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_GET_CONTACTS

Tool Name: Get Contacts

Description

Tool to retrieve a list of contacts. Use when you need to list all contacts in your eTermin account.

Action Parameters

Action Response

data

arrayRequired

error

string

successful

booleanRequired

ETERMIN_GET_RESOURCES

Tool Name: Get Resources

Description

Tool to retrieve all resources. Use when you need to list your eTermin resources before scheduling or managing them.

Action Parameters

resource

stringDefaults to contact

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_GET_SERVICES

Tool Name: Get Services

Description

Tool to retrieve a list of services. Use when you need to list available services in your eTermin account.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_GET_USERS

Tool Name: Get Users

Description

Tool to retrieve a list of users. Use when you need to list all users in your eTermin account.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_GET_WORKING_TIMES

Tool Name: Get Working Times

Description

Tool to retrieve working times for a specific calendar. Use when confirming available time slots before booking appointments.

Action Parameters

calendarid

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_LIST_VOUCHERS

Tool Name: List Vouchers

Description

Tool to list vouchers. Use when you need to retrieve all vouchers in your eTermin account.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_LIST_WEBHOOKS

Tool Name: List Webhooks

Description

Tool to retrieve webhooks. Use when listing all webhooks in your eTermin account.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_UPDATE_CALENDAR

Tool Name: Update calendar

Description

Tool to update an existing calendar. Use when modifying calendar settings by its identifier.

Action Parameters

calendarId

stringRequired

data

objectRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_UPDATE_CONTACT

Tool Name: Update Contact

Description

Tool to update an existing contact in eTermin. Use when you need to modify contact details by ID after confirming it exists.

Action Parameters

contact_id

integerRequired

string

firstname

string

lastname

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_UPDATE_RESOURCE

Tool Name: Update Resource

Description

Tool to update an existing resource. Use after confirming resource existence.

Action Parameters

contentType

stringDefaults to json

data

objectRequired

resource

stringRequired

resourceId

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_UPDATE_SERVICE

Tool Name: Update Service

Description

Tool to update an existing service. Use when you need to modify service details after confirming the service ID.

Action Parameters

calendar_id

string

description

string

duration

integer

name

string

price

number

service_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_UPDATE_VOUCHER

Tool Name: Update Voucher

Description

Tool to update an existing voucher. Use when you need to modify voucher details after creation.

Action Parameters

data

objectRequired

voucherId

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ETERMIN_UPDATE_WEBHOOK

Tool Name: Update Webhook

Description

Tool to update an existing webhook. Use when you need to modify webhook configuration after creation.

Action Parameters

data

objectRequired

webhookId

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired