# Textit

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

- **Category:** ai chatbots
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 31
- **Triggers:** 0
- **Slug:** `TEXTIT`
- **Version:** 20260312_00

## Tools

### Create Campaign

**Slug:** `TEXTIT_CREATE_CAMPAIGN`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the campaign |
| `group` | string | Yes | UUID of the contact group to associate with the campaign |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Contact Group

**Slug:** `TEXTIT_CREATE_GROUP`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the new contact group |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Label

**Slug:** `TEXTIT_CREATE_LABEL`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the label to create |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Contact

**Slug:** `TEXTIT_DELETE_CONTACT`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | The unique UUID of the contact to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Contact Group

**Slug:** `TEXTIT_DELETE_GROUP`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | The UUID of the contact group to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Label

**Slug:** `TEXTIT_DELETE_LABEL`

Tool to delete a message label by UUID. Use when you need to remove an existing label from your TextIt workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | UUID of the label to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Campaign

**Slug:** `TEXTIT_GET_CAMPAIGN`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | UUID of the campaign to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Workspace

**Slug:** `TEXTIT_GET_WORKSPACE`

Tool to retrieve current workspace details including name, country, languages, and timezone. Use when you need workspace configuration information.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Archives

**Slug:** `TEXTIT_LIST_ARCHIVES`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | No | Type of archive to filter by: message or run |
| `after` | string | No | Filter archives after this date (YYYY-MM-DD) |
| `before` | string | No | Filter archives before this date (YYYY-MM-DD) |
| `period` | string | No | Period for archives: daily or monthly |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Broadcasts

**Slug:** `TEXTIT_LIST_BROADCASTS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `flow` | integer | No | Filter by associated flow ID. |
| `after` | string | No | Cursor value to fetch records after this one. |
| `group` | integer | No | Filter by target group ID. |
| `before` | string | No | Cursor value to fetch records before this one. |
| `contact` | integer | No | Filter by target contact ID. |
| `archived` | boolean | No | Filter broadcasts by archived status. |
| `page_size` | integer | No | Number of records per page (must be >= 1). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Campaign Events 2

**Slug:** `TEXTIT_LIST_CAMPAIGN_EVENTS2`

Tool to retrieve campaign events with optional filtering. Use when you need to list scheduled triggers within campaigns, optionally filtering by event UUID or campaign UUID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | No | Filter by event UUID |
| `campaign` | string | No | Filter by campaign UUID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Campaigns

**Slug:** `TEXTIT_LIST_CAMPAIGNS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | No | Filter campaigns by their unique UUID. |
| `after` | string | No | Only include campaigns created after this ISO 8601 datetime. |
| `before` | string | No | Only include campaigns created before this ISO 8601 datetime. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Channels

**Slug:** `TEXTIT_LIST_CHANNELS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination; must be >= 1. |
| `uuid` | string | No | Filter by a specific channel UUID. |
| `schemes` | string | No | Comma-separated list of schemes to filter channels, e.g., "tel,whatsapp". |
| `page_size` | integer | No | Number of results per page; must be >= 1. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Classifiers

**Slug:** `TEXTIT_LIST_CLASSIFIERS`

Tool to list NLU classifiers configured for your organization. Use when you need to retrieve natural language understanding classifiers (wit.ai, luis, bothub) after confirming authentication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | No | Filter by a specific classifier UUID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Contacts

**Slug:** `TEXTIT_LIST_CONTACTS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `urn` | string | No | Filter contacts by their Uniform Resource Name (URN) |
| `uuid` | string | No | Filter contacts by their UUID |
| `after` | string | No | Only include contacts modified after this ISO 8601 datetime |
| `group` | string | No | Filter contacts by group name or UUID |
| `before` | string | No | Only include contacts modified before this ISO 8601 datetime |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List custom contact fields

**Slug:** `TEXTIT_LIST_FIELDS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | Search string to filter fields by name. |
| `page` | integer | No | Page number of results to return (default is 1). |
| `page_size` | integer | No | Number of results per page (default is 50). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Flows

**Slug:** `TEXTIT_LIST_FLOWS`

Tool to retrieve a list of flows for your organization. Use when you need to fetch automated conversation flows with optional filters (UUID, type, archived status, or modified date).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("message" | "voice" | "survey") | No | Enum for flow types. |
| `uuid` | string | No | Filter flows by their UUID |
| `after` | string | No | Only include flows modified after this ISO 8601 datetime |
| `before` | string | No | Only include flows modified before this ISO 8601 datetime |
| `archived` | boolean | No | Filter flows by archived status |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Flow Starts

**Slug:** `TEXTIT_LIST_FLOW_STARTS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `flow` | string | No | UUID of the flow to filter flow starts by. |
| `page` | integer | No | Page number of results to retrieve, must be >= 1. |
| `after` | string | No | Only include flow starts after this ISO 8601 datetime. |
| `before` | string | No | Only include flow starts before this ISO 8601 datetime. |
| `contact` | string | No | UUID of the contact to filter flow starts by. |
| `completed` | boolean | No | Only include completed (true) or incomplete (false) flow starts. |
| `page_size` | integer | No | Number of results per page, must be >= 1. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Globals

**Slug:** `TEXTIT_LIST_GLOBALS`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Groups

**Slug:** `TEXTIT_LIST_GROUPS2`

Tool to list contact groups for your organization. Use when you need to fetch groups with optional filtering by uuid or name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Filter by group name |
| `uuid` | string | No | Filter by group UUID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Labels 2

**Slug:** `TEXTIT_LIST_LABELS2`

Tool to retrieve a list of message labels for your organization. Use when you need to filter labels by UUID or name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Filter by label name |
| `uuid` | string | No | Filter by label UUID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Messages

**Slug:** `TEXTIT_LIST_MESSAGES`

Tool to retrieve a list of messages. Use when you need to fetch messages with optional filters (UUID, folder, contact, broadcast, or date range). Results are paginated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | No | Filter by message UUID |
| `after` | string | No | Filter by created_on after this ISO 8601 datetime |
| `before` | string | No | Filter by created_on before this ISO 8601 datetime |
| `folder` | string ("inbox" | "flows" | "archived" | "outbox" | "sent" | "failed") | No | Enumeration of message folder types. |
| `contact` | string | No | Filter by contact UUID |
| `broadcast` | string | No | Filter by broadcast UUID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Resthook Events

**Slug:** `TEXTIT_LIST_RESTHOOK_EVENTS`

Tool to retrieve recent resthook events for your organization. Use when you need to inspect webhook events that have been triggered, optionally filtered by resthook slug. Events are returned in reverse chronological order.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `resthook` | string | No | Filter by resthook slug to show only events for a specific resthook |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Resthooks

**Slug:** `TEXTIT_LIST_RESTHOOKS`

Tool to list configured resthooks (webhooks). Use when you need to retrieve the resthooks configured in your TextIt account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Cursor value to fetch records after this one. |
| `before` | string | No | Cursor value to fetch records before this one. |
| `page_size` | integer | No | Number of records per page (must be >= 1). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Resthook Subscribers

**Slug:** `TEXTIT_LIST_RESTHOOK_SUBSCRIBERS`

Tool to list webhook subscribers for your organization's resthooks. Use when you need to retrieve the target URLs that receive webhook events for specific resthooks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `resthook` | string | No | Filter subscribers by resthook slug |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Runs

**Slug:** `TEXTIT_LIST_RUNS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `flow` | string | No | UUID of a flow to filter runs. |
| `page` | integer | No | Page number of results to retrieve, must be >= 1. |
| `text` | string | No | Search text within run results. |
| `after` | string | No | Only include runs created after this ISO 8601 timestamp. |
| `group` | string | No | UUID of a group to filter runs by contact group. |
| `before` | string | No | Only include runs created before this ISO 8601 timestamp. |
| `parent` | string | No | UUID of a parent run to filter child runs. |
| `contact` | string | No | UUID of a contact to filter runs. |
| `archived` | boolean | No | If true, only archived runs are returned; if false, only unarchived runs. |
| `ordering` | string | No | Sort results by field(s), prefix with '-' for descending (e.g., '-created_on'). |
| `statuses` | string | No | Comma-separated list of run statuses to include (e.g., active,completed,expired). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tickets

**Slug:** `TEXTIT_LIST_TICKETS`

Tool to retrieve support tickets for your organization. Use when you need to fetch tickets with optional filters (UUID, contact, topic, or assignee). Returns paginated ticket data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | No | Filter tickets by their UUID |
| `topic` | string | No | Filter tickets by topic UUID |
| `contact` | string | No | Filter tickets by contact UUID |
| `assignee` | string | No | Filter tickets by assignee email address |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Topics V2

**Slug:** `TEXTIT_LIST_TOPICS2`

Tool to list topics in the workspace for categorizing tickets. Use when you need to retrieve topics, optionally filtered by UUID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | No | Filter by topic UUID to retrieve a specific topic. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Users

**Slug:** `TEXTIT_LIST_USERS`

Tool to retrieve a list of user logins in your workspace with their roles and teams. Use when you need to fetch users with optional UUID filter. Results are ordered by newest created first.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | No | Filter users by their UUID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Broadcast

**Slug:** `TEXTIT_SEND_BROADCAST`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `text` | object | Yes | The message text translations, with ISO-639-3 language codes as keys. |
| `urns` | array | No | The URNs (Uniform Resource Names) of contacts to send the broadcast to. Each URN should be in full E.164 format. Maximum of 100 URNs. |
| `groups` | array | No | The UUIDs of contact groups to send the broadcast to. Maximum of 100 groups. |
| `contacts` | array | No | The UUIDs of contacts to send the broadcast to. Maximum of 100 contacts. |
| `attachments` | object | No | The attachment translations, with ISO-639-3 language codes as keys. Each list contains media object UUIDs. |
| `base_language` | string | No | The default translation language, specified as an ISO-639-3 language code. |
| `quick_replies` | object | No | The quick replies translations, with ISO-639-3 language codes as keys. Each list contains quick reply objects with 'text' and optional 'extra'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Contact

**Slug:** `TEXTIT_UPDATE_CONTACT`

Tool to update an existing contact. Use after identifying the contact's UUID or URN and preparing details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `urn` | string | No | A URN identifying the contact to update (e.g., tel:+250788123123). |
| `name` | string | No | The contact's display name. |
| `urns` | array | No | List of URNs to associate with the contact (up to 100 items). |
| `uuid` | string | No | The UUID of the contact to update. |
| `fields` | object | No | Key-value pairs for custom contact fields (up to 100 items). |
| `groups` | array | No | List of group UUIDs to assign the contact to (up to 100 items). |
| `language` | string | No | Preferred language of the contact (3-letter ISO code). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |