Textit | Composio Docs

Overview

SLUG: TEXTIT

Description

TextIt is a platform that enables users to build scalable, interactive chatbots across various channels without writing code.

Authentication Details

API Key

generic_api_key

stringRequired

Connecting to Textit

Create an auth config

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

Select App

Navigate to Textit.

Configure Auth Config Settings

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

Create and Get auth config ID

Click “Create Textit 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 textit_auth_config_id = "ac_YOUR_TEXTIT_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 Textit 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, textit_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 Textit 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=["TEXTIT"])
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

TEXTIT_CREATE_CAMPAIGN

Tool Name: Create Campaign

Description

Tool to create a new campaign in textit. use when you need to start a messaging campaign for a specific contact group.

Action Parameters

group

stringRequired

name

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_CREATE_GROUP

Tool Name: Create Contact Group

Description

Tool to create a new contact group. use when segmenting contacts before sending messages.

Action Parameters

name

stringRequired

size

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_CREATE_LABEL

Tool Name: Create Label

Description

Tool to create a new message label. use when you need to categorize messages. example: create a label 'important'. creates a label under your organization using the textit labels api.

Action Parameters

name

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_DELETE_CONTACT

Tool Name: Delete Contact

Description

Tool to delete an existing contact. use when you have the contact's uuid and need to remove it.

Action Parameters

uuid

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_DELETE_GROUP

Tool Name: Delete Contact Group

Description

Tool to delete an existing contact group. use after ensuring the group has no active triggers or campaigns.

Action Parameters

uuid

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_GET_CAMPAIGN

Tool Name: Get Campaign

Description

Tool to retrieve details about a specific campaign. use when you have the campaign's uuid and need its full metadata.

Action Parameters

uuid

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_LIST_ARCHIVES

Tool Name: List Archives

Description

Tool to retrieve a list of message and run archives. use when you need to browse or manage existing archives after authenticating.

Action Parameters

after

string

before

string

period

string

type

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_LIST_BROADCASTS

Tool Name: List Broadcasts

Description

Tool to list broadcasts. use when you need to retrieve broadcasts with optional filters and pagination.

Action Parameters

after

string

archived

boolean

before

string

contact

integer

flow

integer

group

integer

page_size

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_LIST_CAMPAIGN_EVENTS

Tool Name: List Campaign Events

Description

Tool to retrieve a list of campaign events. use when you need to inspect scheduling or delivery settings; optionally filter by campaign uuid.

Action Parameters

campaign

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_LIST_CAMPAIGNS

Tool Name: List Campaigns

Description

Tool to list campaigns. use after authentication to retrieve campaigns, optionally filtering by uuid or date range.

Action Parameters

after

string

before

string

uuid

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_LIST_CHANNELS

Tool Name: List Channels

Description

Tool to list channels. use when you need to retrieve a paginated list of your organization's channels after confirming authentication.

Action Parameters

page

integer

page_size

integer

schemes

string

uuid

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_LIST_CONTACTS

Tool Name: List Contacts

Description

Tool to retrieve a list of contacts. use when you need to fetch contacts with optional filters (uuid, urn, group, or modified date). use after authenticating your client.

Action Parameters

after

string

before

string

group

string

urn

string

uuid

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_LIST_FIELDS

Tool Name: List custom contact fields

Description

Tool to retrieve a list of custom contact fields. use when you need to view or filter all defined contact fields with pagination and optional search.

Action Parameters

page

integer

page_size

integer

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_LIST_FLOW_STARTS

Tool Name: List Flow Starts

Description

Tool to retrieve a list of manual flow starts. use when you need to fetch flow start records with optional filters and pagination.

Action Parameters

after

string

before

string

completed

boolean

contact

string

flow

string

page

integer

page_size

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_LIST_GLOBALS

Tool Name: List Globals

Description

Tool to list global variables. use when you need to retrieve all workspace-level variables after authenticating.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_LIST_GROUPS

Tool Name: List Groups

Description

Tool to list contact groups. use when you need to fetch and paginate groups after authenticating.

Action Parameters

name

string

page

integer

page_size

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_LIST_LABELS

Tool Name: List Labels

Description

Tool to retrieve a list of message labels. use when you need to paginate through labels in your textit workspace.

Action Parameters

page

integer

page_size

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_LIST_RUNS

Tool Name: List Runs

Description

Tool to retrieve a list of flow runs. use when you need to filter or browse run history by flow, contact, or status.

Action Parameters

after

string

archived

boolean

before

string

contact

string

flow

string

group

string

ordering

string

page

integer

parent

string

statuses

string

text

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_LIST_TOPICS

Tool Name: List Topics

Description

Tool to list topics in the workspace. use when you need to retrieve all topics, optionally paginated. use after authenticating with a valid token.

Action Parameters

after

string

page

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_SEND_BROADCAST

Tool Name: Send Broadcast

Description

Tool to send a new broadcast message. use after composing message translations and selecting recipients (urns, contacts, or groups).

Action Parameters

attachments

object

base_language

string

contacts

array

groups

array

quick_replies

object

text

objectRequired

urns

array

Action Response

data

objectRequired

error

string

successful

booleanRequired

TEXTIT_UPDATE_CONTACT

Tool Name: Update Contact

Description

Tool to update an existing contact. use after identifying the contact's uuid or urn and preparing details.

Action Parameters

fields

object

groups

array

language

string

name

string

urn

string

urns

array

uuid

string

Action Response

data

objectRequired

error

string

successful

booleanRequired