Kit
Your Toolhouse AI Worker can connect to Kit using 42 specialized tools.
Auth Connection
This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under Auth Connections.
Tools (42)
Kit Add Subscriber To Form
Kit Add Subscriber To FormIntegration name: KIT_ADD_SUBSCRIBER_TO_FORM
Add an existing subscriber to a form by their IDs. This action associates a subscriber with a form in Kit. The subscriber must already exist in your Kit account (use KIT_LIST_SUBSCRIBERS to find them). The form must also exist (use KIT_LIST_FORMS to find valid form IDs). Returns HTTP 201 if the subscriber is newly added to the form, or HTTP 200 if they were already associated with the form. Both cases are considered successful operations. Important: This action requires both form_id and subscriber_id (aliased as 'id' in requests). An optional referrer URL can be provided for tracking purposes and will have its UTM parameters automatically parsed.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
3887204854
The ID of the subscriber to add to the form. Use KIT_LIST_SUBSCRIBERS to get valid subscriber IDs. The subscriber must already exist in your Kit account.
form_id
integer
✅
9023516
The ID of the form to which the subscriber will be added. Use KIT_LIST_FORMS to get valid form IDs.
referrer
string
"https://example.com/landing-page?utm_source=newsletter&utm_medium=email"
Optional referrer URL for tracking purposes. Can include UTM parameters (e.g., utm_source, utm_medium, utm_campaign) which will be parsed and included in the response.
Kit Add Subscriber To Form By Email
Kit Add Subscriber To Form By EmailIntegration name: KIT_ADD_SUBSCRIBER_TO_FORM_BY_EMAIL
Tool to add an existing subscriber to a form using their email address. Use when you know the subscriber's email but not their ID. The subscriber must already exist in your Kit account before adding them to a form. Returns HTTP 201 if the subscriber is newly added to the form, or HTTP 200 if they were already associated with the form.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
form_id
integer
✅
9023516
The ID of the form to which the subscriber will be added. Use KIT_LIST_FORMS to get valid form IDs.
referrer
string
"https://example.com/landing-page?utm_source=newsletter&utm_medium=email"
Optional referrer URL for tracking purposes. Can include UTM parameters (e.g., utm_source, utm_medium, utm_campaign) which will be parsed and included in the response.
email_address
string
✅
"test-subscriber-kit-api@example.com"
The email address of the subscriber to add to the form. The subscriber must already exist in your Kit account.
Kit Create Broadcast
Kit Create BroadcastIntegration name: KIT_CREATE_BROADCAST
Tool to create a new broadcast (email campaign) to send to subscribers. Use when you need to draft, schedule, or immediately publish an email broadcast. To save as draft, set send_at to null; to schedule, provide a future send_at timestamp; to publish to web, set public to true.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
public
boolean
false
Whether to publish the broadcast to your public creator profile. Set to true to make it visible on your website.
content
string
✅
"<h1>Welcome!</h1><p>This is our weekly update.</p>"
Email content/body (HTML or plain text)
send_at
string
"2024-03-15T14:30:00Z"
Scheduled send time in ISO 8601 format. Set to null to save as draft without scheduling. Must be a future timestamp.
subject
string
✅
"Weekly Newsletter"
Email subject line for the broadcast
description
string
"Q1 Newsletter - February edition"
Internal description for the broadcast (not visible to subscribers)
email_address
string
"hello@example.com"
Sending email address to use for the broadcast. Uses the account's default sending email address if not provided. Must be a confirmed email address associated with your account.
email_template_id
integer
6
ID of the email template to use for styling. If not provided, the default template will be used.
subscriber_filter
array
[{"all":[{"type":"all_subscribers"}]}]
Array of filter groups to target specific subscribers. Each group contains conditions combined with 'all' logic. If not provided, sends to all subscribers.
Kit Create Custom Field
Kit Create Custom FieldIntegration name: KIT_CREATE_CUSTOM_FIELD
Tool to create a new custom field for subscriber data. Use when you need to store extra attributes for subscribers.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
label
string
✅
"Favorite Color"
The display label for the custom field (e.g., 'Favorite Color').
Kit Create Subscriber
Kit Create SubscriberIntegration name: KIT_CREATE_SUBSCRIBER
Tool to create a new subscriber or update an existing one (upsert). If a subscriber with the provided email address does not exist, creates one. If already exists, updates the first name.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
state
string
"active"
Valid states for a subscriber.
fields
object
{"role":"Developer","company":"Acme Corp"}
Custom fields as key-value pairs. Custom fields that don't exist will be ignored by the API.
first_name
string
"John"
The subscriber's first name. If the subscriber already exists, this will update their first name.
email_address
string
✅
"test@example.com"
The subscriber's email address (required). If a subscriber with this email already exists, their first name will be updated.
Kit Create Tag
Kit Create TagIntegration name: KIT_CREATE_TAG
Tool to create a new tag in the account. Use when you need a custom label to segment subscribers. Use after confirming tag uniqueness to avoid duplicates. Example: "Create a tag called 'VIP' for premium customers."
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
name
string
✅
"VIP"
Name of the tag to be created.
Kit Create Webhook
Kit Create WebhookIntegration name: KIT_CREATE_WEBHOOK
Creates a webhook subscription for real-time event notifications. Use this to receive HTTP POST notifications when subscriber events (activate, unsubscribe, form subscribe, tag add/remove, link clicks, etc.) or purchase events occur in your Kit account.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
event
object
✅
—
Event type and optional filters for the webhook subscription.
target_url
string
✅
"https://example.com/webhook"
HTTPS URL endpoint that will receive webhook POST notifications when the event triggers.
Kit Delete Broadcast
Kit Delete BroadcastIntegration name: KIT_DELETE_BROADCAST
Tool to delete a specific broadcast. Use when you need to permanently remove a broadcast by ID (after confirming the ID). Example prompt: "Delete broadcast with ID 123"
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
123
Unique identifier of the broadcast to delete
Kit Delete Custom Field
Kit Delete Custom FieldIntegration name: KIT_DELETE_CUSTOM_FIELD
Tool to delete a specific custom field. Use after confirming the custom field ID is correct. Deletes the field permanently.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
123
Unique identifier of the custom field to delete
Kit Delete Subscriber
Kit Delete SubscriberIntegration name: KIT_DELETE_SUBSCRIBER
Unsubscribe a subscriber from all email communications by their ID. This action permanently unsubscribes a subscriber, removing them from all sequences and forms. The subscriber's historical data is retained but they will no longer receive emails. This operation is idempotent - unsubscribing an already-unsubscribed subscriber succeeds without error. Use KIT_LIST_SUBSCRIBERS to find valid subscriber IDs before calling this action. Returns: Empty response on success (HTTP 204 No Content). Raises: ExecutionFailed: If the subscriber ID doesn't exist (404), authentication fails (401), or other API errors occur.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
3887204736
The unique subscriber ID to unsubscribe. Must be a positive integer. Use KIT_LIST_SUBSCRIBERS to find valid subscriber IDs.
Kit Delete Tag
Kit Delete TagIntegration name: KIT_DELETE_TAG
Tool to delete a tag by ID. Use when you need to remove obsolete or incorrect tags after confirming the tag exists.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
123
Unique identifier of the tag to delete
Kit Delete Webhook
Kit Delete WebhookIntegration name: KIT_DELETE_WEBHOOK
Tool to delete a webhook by ID. Use when you want to permanently remove a webhook after confirming its ID.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
123
Unique identifier of the webhook to delete
Kit Filter Subscribers
Kit Filter SubscribersIntegration name: KIT_FILTER_SUBSCRIBERS
Tool to filter subscribers based on engagement criteria such as email opens, clicks, or delivery status. Use when you need to segment subscribers by their engagement behavior with specific date ranges and count thresholds.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
all
array
✅
[{"type":"opens","after":"2025-01-01","before":"2026-12-31","count_greater_than":0}]
Array of filter conditions where ALL must be met (AND logic). At least one condition is required. Each condition filters subscribers based on engagement type (opens, clicks, sent, delivered, subscribed) with optional count and date constraints.
Kit Get Account
Kit Get AccountIntegration name: KIT_GET_ACCOUNT
Tool to retrieve current account information. Use after validating API key to fetch account ID, plan type, primary email, and timezone details.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
No parameters required.
Kit Get Account Colors
Kit Get Account ColorsIntegration name: KIT_GET_ACCOUNT_COLORS
Tool to retrieve list of colors associated with the account. Use after confirming authentication to fetch account-specific color palette.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
No parameters required.
Kit Get Broadcast
Kit Get BroadcastIntegration name: KIT_GET_BROADCAST
Tool to retrieve details of a specific broadcast by ID. Use when you have a valid broadcast ID and need its metadata.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
2786
Unique identifier of the broadcast to retrieve
Kit Get Broadcast Clicks
Kit Get Broadcast ClicksIntegration name: KIT_GET_BROADCAST_CLICKS
Tool to retrieve link click data for a specific broadcast by ID. Use when you need to analyze which links were clicked and their engagement metrics.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
after
string
"WzIwXQ=="
Pagination cursor to retrieve results after this cursor
before
string
"WzMwXQ=="
Pagination cursor to retrieve results before this cursor
per_page
integer
100
Number of results per page; must be between 1 and 500
broadcast_id
integer
✅
22933243
Unique identifier of the broadcast to fetch click data for
Kit Get Broadcast Stats
Kit Get Broadcast StatsIntegration name: KIT_GET_BROADCAST_STATS
Tool to retrieve statistics for a specific broadcast by ID. Use after a broadcast has been sent to monitor performance.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
123
Unique identifier of the broadcast to fetch statistics for
Kit Get Creator Profile
Kit Get Creator ProfileIntegration name: KIT_GET_CREATOR_PROFILE
Tool to retrieve the creator profile information for the account. Use when you need creator metadata (name, bio, avatar, profile URL) before publishing or customizing content.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
No parameters required.
Kit Get Email Stats
Kit Get Email StatsIntegration name: KIT_GET_EMAIL_STATS
Tool to retrieve email statistics for the account. Use after confirming authentication to fetch metrics on emails (sent, opened, clicked) over the last 90 days.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
No parameters required.
Kit Get Growth Stats
Kit Get Growth StatsIntegration name: KIT_GET_GROWTH_STATS
Tool to retrieve growth statistics for the account over a date range. Stats are returned in your sending time zone (not UTC). Defaults to last 90 days if no dates specified.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
ending
string
"2024-03-31"
Get stats for time period ending on this date (format yyyy-mm-dd). Defaults to today.
starting
string
"2024-01-01"
Get stats for time period beginning on this date (format yyyy-mm-dd). Defaults to 90 days ago.
Kit Get Subscriber
Kit Get SubscriberIntegration name: KIT_GET_SUBSCRIBER
Tool to retrieve a specific subscriber by their ID. Use when you need to fetch detailed information about a single subscriber.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
3937322930
The unique subscriber ID to retrieve. Must be a positive integer.
Kit Get Subscriber Stats
Kit Get Subscriber StatsIntegration name: KIT_GET_SUBSCRIBER_STATS
Tool to retrieve email stats for a specific subscriber. Use when you need subscriber engagement metrics (opens, clicks, bounces, rates). Data only available for events from June 2025 onwards.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
subscriber_id
integer
✅
3937323835
The ID of the subscriber to get stats for
email_sent_after
string
"2025-06-24"
Filter to stats for emails sent after this date (YYYY-MM-DD format). Must be on or after 2025-06-24.
email_sent_before
string
"2025-12-31"
Filter to stats for emails sent before this date (YYYY-MM-DD format)
Kit List Broadcasts
Kit List BroadcastsIntegration name: KIT_LIST_BROADCASTS
Tool to retrieve a paginated list of all broadcasts. Use when you need to enumerate or review broadcast summaries with cursor-based pagination.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
after
string
"cursor_abc123"
Cursor for pagination; returns results after the specified cursor.
before
string
"cursor_xyz789"
Cursor for pagination; returns results before the specified cursor.
per_page
integer
100
Number of results per page; must be between 1 and 500.
include_total_count
string
"true"
If set to 'true', includes the total count of records in the response.
Kit List Custom Fields
Kit List Custom FieldsIntegration name: KIT_LIST_CUSTOM_FIELDS
Tool to retrieve a paginated list of custom fields. Use after confirming you need to enumerate or inspect all custom fields with cursor-based pagination.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
after
string
"cursor_abc123"
Cursor for pagination; returns results after the specified cursor.
before
string
"cursor_xyz789"
Cursor for pagination; returns results before the specified cursor.
per_page
integer
100
Number of results per page; defaults to 500 if not specified.
include_total_count
string
"true"
If set to 'true', includes the total count of records in the response.
Kit List Email Templates
Kit List Email TemplatesIntegration name: KIT_LIST_EMAIL_TEMPLATES
Retrieve a paginated list of all email templates in the Kit account. Returns template details including ID, name, default status, and category. Supports cursor-based pagination for navigating large template collections. Use this when you need to view or iterate through email templates.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
after
string
"WzE1MDUyMDc5XQ=="
Cursor for fetching the next page of results. Use the 'end_cursor' value from a previous response.
before
string
"WzE1MDUyMTA4XQ=="
Cursor for fetching the previous page of results. Use the 'start_cursor' value from a previous response.
per_page
integer
100
Number of email templates to return per page. Default is 500, maximum is 1000.
include_total_count
boolean
—
Include the total count of email templates in the response. Note: This may slow down the response for large collections.
Kit List Forms
Kit List FormsIntegration name: KIT_LIST_FORMS
Lists all forms in your Kit account with optional filtering and cursor-based pagination. Use this to retrieve forms when you need to:
Get all available forms (landing pages and embedded forms)
Filter by status (active, archived, trashed) or type (embed, hosted)
Paginate through large collections of forms
Get form IDs and metadata for other operations
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
type
string
"embed"
Filter forms by type.
after
string
"cursor_abc123"
Cursor for pagination; returns results after the specified cursor.
before
string
"cursor_xyz789"
Cursor for pagination; returns results before the specified cursor.
status
string
"active"
Filter forms by status: 'active' (default), 'archived', 'trashed', or 'all'.
per_page
integer
25
Number of forms to return per page (default: 500, max: 1000).
include_total_count
boolean
true
If set to true, includes the total count of forms in the response (may be slower for large collections).
Kit List Segments
Kit List SegmentsIntegration name: KIT_LIST_SEGMENTS
Tool to retrieve a paginated list of segments. Use when you need to enumerate segments with cursor-based pagination for further processing or display.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
after
string
"cursor_abc123"
Cursor for pagination; returns results after this cursor.
before
string
"cursor_xyz789"
Cursor for pagination; returns results before this cursor.
per_page
integer
25
Number of segments to return per page (min 1).
include_total_count
string
"true"
If set to 'true', includes the total count of segments in the response.
Kit List Sequences
Kit List SequencesIntegration name: KIT_LIST_SEQUENCES
Tool to retrieve a paginated list of all sequences. Use when you need to enumerate sequences with pagination for further processing or display.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
after
string
"cursor_abc123"
Cursor for pagination; returns results after the specified cursor.
before
string
"cursor_xyz789"
Cursor for pagination; returns results before the specified cursor.
per_page
integer
100
Number of results per page (max 1000, default 500).
include_total_count
string
"true"
If set to 'true', includes the total count in the pagination.
Kit List Subscribers
Kit List SubscribersIntegration name: KIT_LIST_SUBSCRIBERS
Tool to retrieve a list of subscribers. Use when you need to fetch subscriber records with optional filtering, sorting, and pagination.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
after
string
"cursor_abc123"
Cursor for pagination; returns subscribers after this cursor.
before
string
"cursor_xyz789"
Cursor for pagination; returns subscribers before this cursor.
status
string
"active"
Filter by subscriber status (e.g., 'active' or 'inactive').
per_page
integer
25
Number of subscribers to return per page (min 1).
sort_field
string
"id"
Field by which to sort the subscribers. Must be one of: 'id', 'cancelled_at', or 'updated_at'. Note: If 'cancelled_at' is used, the status parameter must be set to 'cancelled'.
sort_order
string
"asc"
Order in which to sort the results.
created_after
string
"2023-01-01"
Filter to subscribers created after this date (YYYY-MM-DD).
email_address
string
"user@example.com"
Exact email address to filter by.
updated_after
string
"2023-01-01"
Filter to subscribers updated after this date (YYYY-MM-DD).
created_before
string
"2023-12-31"
Filter to subscribers created before this date (YYYY-MM-DD).
updated_before
string
"2023-12-31"
Filter to subscribers updated before this date (YYYY-MM-DD).
include_total_count
string
"true"
If set to 'true', includes the total count of subscribers in the response.
Kit List Subscribers For Form
Kit List Subscribers For FormIntegration name: KIT_LIST_SUBSCRIBERS_FOR_FORM
Retrieves subscribers for a specific form by ID with optional filtering and cursor-based pagination. Use this action to:
Get all subscribers who have joined a specific form
Filter subscribers by when they were added to the form (added_after/added_before)
Filter subscribers by when they were created (created_after/created_before)
Filter by subscriber status (e.g., 'active')
Navigate through results using cursor-based pagination (after/before cursors)
Control page size with per_page parameter
Optionally get total subscriber count with include_total_count='true'
First use KIT_LIST_FORMS to get valid form_id values.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
after
string
"cursor_abc123"
Cursor for pagination; returns results after this cursor.
before
string
"cursor_xyz789"
Cursor for pagination; returns results before this cursor.
status
string
"active"
Filter subscribers by status (e.g., 'active').
form_id
integer
✅
123
ID of the form whose subscribers you want to retrieve.
per_page
integer
25
Number of results to return per page (min 1).
added_after
string
"2021-01-01T00:00:00Z"
Return subscribers added to the form after this date/time (ISO 8601).
added_before
string
"2021-12-31T23:59:59Z"
Return subscribers added to the form before this date/time (ISO 8601).
created_after
string
"2021-01-01T00:00:00Z"
Return subscribers created after this date/time (ISO 8601).
created_before
string
"2021-12-31T23:59:59Z"
Return subscribers created before this date/time (ISO 8601).
include_total_count
string
"true"
If 'true', includes the total count of subscribers in the response.
Kit List Tags
Kit List TagsIntegration name: KIT_LIST_TAGS
Retrieve a paginated list of all tags in the Kit account. Returns tag details including ID, name, and creation date. Supports cursor-based pagination for navigating large tag collections. Use this when you need to view or iterate through tags.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
after
string
"WzE1MDUyMDc5XQ=="
Cursor for fetching the next page of results. Use the 'end_cursor' value from a previous response.
before
string
"WzE1MDUyMTA4XQ=="
Cursor for fetching the previous page of results. Use the 'start_cursor' value from a previous response.
per_page
integer
100
Number of tags to return per page. Default is 500, maximum is 1000.
include_total_count
boolean
—
Include the total count of tags in the response. Note: This may slow down the response for large collections.
Kit List Tag Subscribers
Kit List Tag SubscribersIntegration name: KIT_LIST_TAG_SUBSCRIBERS
Tool to retrieve subscribers for a specific tag. Use after confirming the tag ID when you need to list subscribers associated with a tag.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
after
string
"cursor_abc123"
Cursor for pagination; returns subscribers after this cursor.
before
string
"cursor_xyz789"
Cursor for pagination; returns subscribers before this cursor.
status
string
"active"
Filter by subscriber status ('active' or 'inactive').
tag_id
integer
✅
123
Unique identifier of the tag to retrieve subscribers for
per_page
integer
25
Number of subscribers to return per page (min 1).
tagged_after
string
"2023-01-01T00:00:00Z"
Filter to subscribers tagged after this timestamp (ISO 8601).
created_after
string
"2023-01-01T00:00:00Z"
Filter to subscribers created after this timestamp (ISO 8601).
tagged_before
string
"2023-12-31T23:59:59Z"
Filter to subscribers tagged before this timestamp (ISO 8601).
created_before
string
"2023-12-31T23:59:59Z"
Filter to subscribers created before this timestamp (ISO 8601).
include_total_count
string
"true"
If set to 'true', includes total count of subscribers in the response.
Kit List Webhooks
Kit List WebhooksIntegration name: KIT_LIST_WEBHOOKS
Retrieve a paginated list of all webhooks configured in the Kit account. Returns webhook details including ID, event type, and target URL. Supports cursor-based pagination for navigating large webhook collections. Use this when you need to view or iterate through webhooks.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
after
string
"WzE1MDUyMDc5XQ=="
Cursor for fetching the next page of results. Use the 'end_cursor' value from a previous response.
before
string
"WzE1MDUyMTA4XQ=="
Cursor for fetching the previous page of results. Use the 'start_cursor' value from a previous response.
per_page
integer
100
Number of webhooks to return per page. Default is 500, maximum is 1000.
Kit Remove Tag From Subscriber
Kit Remove Tag From SubscriberIntegration name: KIT_REMOVE_TAG_FROM_SUBSCRIBER
Tool to remove a tag from a subscriber using their subscriber ID. Use when you need to untag a subscriber from a specific tag after confirming both tag and subscriber IDs exist.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
tag_id
integer
✅
15052356
The unique ID of the tag to remove from the subscriber
subscriber_id
integer
✅
3937323879
The unique ID of the subscriber to remove the tag from
Kit Tag Subscriber
Kit Tag SubscriberIntegration name: KIT_TAG_SUBSCRIBER
Tool to associate a subscriber with a specific tag by ID. Use after confirming tag and subscriber IDs when tagging a subscriber.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
tag_id
integer
✅
123
ID of the tag to assign
subscriber_id
integer
✅
456
ID of the subscriber to tag
Kit Tag Subscriber By Email
Kit Tag Subscriber By EmailIntegration name: KIT_TAG_SUBSCRIBER_BY_EMAIL
Assigns a tag to an existing subscriber using their email address. The subscriber must already exist in your Kit account. Returns the subscriber's details including the timestamp when they were tagged. Use when you have a valid tag ID and the subscriber's email address.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
tag_id
integer
✅
123
The ID of the tag to assign to the subscriber
email_address
string
✅
"user@example.com"
The subscriber's email address. The subscriber must already exist in your Kit account.
Kit Untag Subscriber By Email
Kit Untag Subscriber By EmailIntegration name: KIT_UNTAG_SUBSCRIBER_BY_EMAIL
Tool to remove a tag from a subscriber using their email address. Use when you need to untag an existing subscriber after confirming both the tag ID and subscriber's email address are valid.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
tag_id
integer
✅
123
The ID of the tag to remove from the subscriber
email_address
string
✅
"user@example.com"
The email address of the subscriber to untag. The subscriber must already exist in your Kit account.
Kit Update Account Colors
Kit Update Account ColorsIntegration name: KIT_UPDATE_ACCOUNT_COLORS
Tool to update the list of colors for the account. Use when customizing your Kit account's color palette for broadcasts and templates. Maximum 5 hex color codes allowed per account.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
colors
array
✅
["#008000","#FF0000"]
List of hex color codes to set for the account (e.g., '#008000', '#FF0000'). Maximum 5 colors allowed.
Kit Update Custom Field
Kit Update Custom FieldIntegration name: KIT_UPDATE_CUSTOM_FIELD
Tool to update a custom field's label. Use after listing or retrieving custom fields and confirming the field ID to rename.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
123
Unique identifier of the custom field to update
label
string
✅
"New Custom Field Label"
New label for the custom field
Kit Update Subscriber
Kit Update SubscriberIntegration name: KIT_UPDATE_SUBSCRIBER
Tool to update an existing subscriber's information. Use when you need to modify a subscriber's first name, email address, or custom fields. Supports updating up to 140 custom fields at a time.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
3937323106
The unique subscriber ID to update. Must be a positive integer. Use KIT_LIST_SUBSCRIBERS to find valid subscriber IDs.
fields
object
{"company":"Acme Corp","favorite_color":"blue"}
Custom fields as key-value pairs. Maximum 140 custom fields can be updated at a time. The API will ignore custom fields that don't exist in your account.
first_name
string
"UpdatedUser"
The subscriber's first name to update.
email_address
string
"test_updated_subscriber@example.com"
The subscriber's email address to update.
Kit Update Tag
Kit Update TagIntegration name: KIT_UPDATE_TAG
Tool to update a tag's name by ID. Use after retrieving tag ID and confirming the new name.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
integer
✅
123
Unique identifier of the tag to update
name
string
✅
"Summer Sale"
New name for the tag