Centralstationcrm

Learn how to use Centralstationcrm with Composio

Overview

SLUG: CENTRALSTATIONCRM

Description

CentralStationCRM is an easy-to-use CRM software focusing on collaboration and long-term customer relationships.

Authentication Details

subdomain
stringRequired
generic_api_key
stringRequired

Connecting to Centralstationcrm

Create an auth config

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

1

Select App

Navigate to the Centralstationcrm toolkit page and click “Setup Integration”.

2

Configure Auth Config Settings

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

3

Create and Get auth config ID

Click “Create Integration”. 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

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

Tools

Executing tools

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

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["CENTRALSTATIONCRM"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def 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
33invoke_llm()

Tool List

Tool Name: Check Connection

Description

Tool to verify the connection status of the centralstationcrm api key. use when validating credentials before making other api calls.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Count People

Description

Tool to retrieve the total number of people in the account. use when you need the current total number of contacts in your centralstationcrm account. example: "how many contacts exist in my account?"

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Company

Description

Tool to create a new company record. use when you need to add an organization to your crm before linking it to contacts or deals.

Action Parameters

background
string
group_id
integer
name
stringRequired
user_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Deal

Description

Tool to create a new deal record. use when needing to log a sales opportunity after grouping contacts or companies.

Action Parameters

background
string
company_id
integer
currency
string
current_state
string
finished_at
string
group_id
integer
name
stringRequired
person_ids_set
string
target_date
stringRequired
user_id
integer
value
stringRequired
value_count
string
value_sum
string
value_type
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Person

Description

Tool to create a new person record. use when you need to add a person to your crm before linking them to other records.

Action Parameters

background
string
first_name
string
gender
string
name
stringRequired
title
string
user_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Person Address

Description

Tool to create a new address for a specific person. use when you need to add or update postal details after confirming person id.

Action Parameters

atype
stringRequired
city
stringRequired
country_code
string
person_id
integerRequired
primary
boolean
state_code
string
street
string
zip
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Person Assistant

Description

Tool to create a new assistant (assi) entry for a specific person. use after confirming the person id when you need to manage assistant contacts.

Action Parameters

email
string
name
stringRequired
person_id
integerRequired
primary
boolean
tel
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Person Avatar

Description

Tool to create a new avatar for a specific person. use when you need to attach a base64-encoded image file after confirming the person's id.

Action Parameters

avatar
objectRequired
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Person Contact Detail

Description

Tool to create a new contact detail for a specific person. use when adding a phone number after confirming the person's id.

Action Parameters

atype
stringRequired
name
stringRequired
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Person Historic Event

Description

Tool to create a new historic event for a specific person. use after confirming person id to record dates like birthdays, anniversaries, or other milestones.

Action Parameters

atype
stringRequired
desc
string
name
stringRequired
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Company

Description

Tool to delete a company record by id. use when you need to permanently remove an organization after verifying the correct id.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete person

Description

Tool to delete a person record by id. use when you need to permanently remove a contact after verifying the correct id.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Person Address

Description

Tool to delete a person's address by its id. use when you need to remove an outdated or incorrect address after confirming the person id and address id.

Action Parameters

address_id
integerRequired
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Person Assi

Description

Tool to delete an assi entry of a person. use when you need to remove an assistant record after confirming person id and assi id.

Action Parameters

assi_id
integerRequired
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Person Avatar

Description

Tool to delete a person's avatar by its id. use when you need to remove an outdated or incorrect avatar after confirming the person id and avatar id.

Action Parameters

avatar_id
stringRequired
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Person Contact Detail

Description

Tool to delete a contact detail of a person. use when you need to remove an outdated or incorrect contact detail after confirming the person id and contact detail id.

Action Parameters

contact_detail_id
integerRequired
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Person Historic Event

Description

Tool to delete a historic event of a person by its id. use when you need to remove outdated or incorrect milestone entries after confirming the person id and historic event id.

Action Parameters

historic_event_id
integerRequired
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get API User Maildrop

Description

Tool to retrieve the current api user's maildrop for people and companies. use after authenticating the api user.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Company

Description

Tool to retrieve details of a specific company by id. use after confirming the company id.

Action Parameters

company_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Deal

Description

Tool to retrieve details of a specific deal by its id. use when you have a confirmed deal id.

Action Parameters

deal_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Deals

Description

Tool to retrieve a paginated list of all deals. use when you need to list deals with pagination and optional includes (e.g., companies, tags) or additional methods.

Action Parameters

includes
array
methods
array
page
integer
perpage
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Person

Description

Tool to retrieve details of a specific person by id. use when you have a person id and need their full details.

Action Parameters

includes
array
methods
array
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Persons

Description

Tool to retrieve a paginated list of all people. use when listing contacts with pagination and optional includes.

Action Parameters

includes
array
page
integer
perpage
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Person Address

Description

Tool to retrieve a specific address of a person by address id. use after confirming person and address ids. example: "fetch address for person #42, address #101."

Action Parameters

address_id
integerRequired
methods
string
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Person Addresses

Description

Tool to retrieve all addresses for a specific person. use when you need to list a person’s addresses after confirming their id. example: "get addresses for person with id 42."

Action Parameters

includes
string
methods
string
page
integer
perpage
integer
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Person Assi

Description

Tool to retrieve a specific assi entry of a person by id. use after confirming person id and assi id.

Action Parameters

assi_id
integerRequired
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Person Assis

Description

Tool to retrieve all assistant entries for a specific person. use after confirming the person id. example: "list assistants for person with id 42."

Action Parameters

order
string
page
integer
perpage
integer
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Person Avatar

Description

Tool to retrieve a specific avatar of a person by avatar id. use after you know both person id and avatar id to fetch the base64-encoded image.

Action Parameters

avatar_id
stringRequired
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Person Avatars

Description

Tool to retrieve all avatars for a specific person. use when you need to list a person’s avatars after confirming their id. example: "list avatars for person with id 42."

Action Parameters

person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Person Contact Detail

Description

Tool to retrieve a specific contact detail by id for a person. use after confirming person and contact detail ids. example: "fetch contact detail #108 for person #42."

Action Parameters

contact_detail_id
integerRequired
methods
string
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Person Custom Fields

Description

Tool to retrieve all custom fields for a specific person. use when you need to access a person's custom fields after confirming their id.

Action Parameters

person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Person Historic Event

Description

Tool to retrieve a specific historic event of a person by id. use after confirming both person and event ids. example: "fetch historic event 101 for person 42."

Action Parameters

event_id
integerRequired
includes
string
methods
string
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Person Historic Events

Description

Tool to retrieve all historic events for a specific person. use when you need to list a person's historical dates after confirming their id.

Action Parameters

order
string
page
integer
perpage
integer
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Merge Person

Description

Tool to merge another person into an existing person by id. use after identifying duplicate records to consolidate them. example: merge person 42 with [43,44].

Action Parameters

group_id
integer
looser_ids
arrayRequired
no_log
boolean
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Search People

Description

Tool to retrieve people matching search criteria. use when you need to find specific contacts by name, email, or phone after authenticating with your api key.

Action Parameters

page
integer
per_page
integer
query
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Stats People

Description

Tool to retrieve key statistics about people. use when you need a quick summary of total entries, e.g., after filtering by tag or custom criteria.

Action Parameters

filter
object
tag_id
integer
tag_name
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Company

Description

Tool to update an existing company by id. use after retrieving the company's details when you need to modify one or more fields.

Action Parameters

background
string
company_id
integerRequired
group_id
integer
name
stringRequired
no_log
boolean
user_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Person

Description

Tool to update an existing person by id. use after retrieving the person's current details when you need to modify one or more fields.

Action Parameters

background
string
first_name
string
gender
string
name
string
person_id
integerRequired
title
string
user_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Person Address

Description

Tool to update a specific address of a person. use after retrieving the person's addresses to modify one.

Action Parameters

address_id
integerRequired
atype
string
city
stringRequired
country_code
string
person_id
integerRequired
primary
boolean
state_code
string
street
string
zip
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Person Assi

Description

Tool to update an assi entry of a person. use when you need to modify a specific assistant record after retrieving the person’s assis list. example: "update assi 101 for person 42 changing email to foo@example.com".

Action Parameters

assi_id
integerRequired
email
string
name
stringRequired
person_id
integerRequired
primary
boolean
tel
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Person Contact Detail

Description

Tool to update a specific contact detail of a person by id. use after retrieving the person's contact details to modify one.

Action Parameters

atype
stringRequired
contact_detail_id
integerRequired
location_id
integer
name
stringRequired
person_id
integerRequired
primary
boolean
visible
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Person Historic Event

Description

Tool to update a historic event of a person by id. use after retrieving the event when you need to modify its details. example: "update historic event 101 for person 42 changing atype to anniversary."

Action Parameters

atype
stringRequired
desc
string
event_id
integerRequired
name
stringRequired
person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired