--- title: Kustomer API Integration on Truto slug: kustomer category: Helpdesk canonical: "https://truto.one/integrations/detail/kustomer/" --- # Kustomer API Integration on Truto **Category:** Helpdesk **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. ### Unified Ticketing API - **Accounts** — Accounts represent the companies or organizations that you are in contact with. Accounts have one or more Contacts associated with them. - **Attachments** — Attachments are the files associated with a ticket or a comment. - **Comments** — Comments represent the communication happening on a Ticket, both between a User and a Contact and the internal things like notes, private comments, etc. A Ticket can have one or more Comments. - **Contacts** — Contact represent the external people you are in contact with. These could be customers, leads, etc. Contacts can be associated with an Account if the underlying product supports it. - **Fields** — Fields represent the attributes defined for various entities in the underlying product. Depending on the underlying product, custom attributes can be defined by a User on various entities like Ticket, Contact, etc. is_user_defined attribute within Field can be used to differentiate between custom and system defined Fields. - **Tags** — Tags represent a common classification approach used in various ticketing systems. A Ticket may have one or more Tags associated with them. - **Teams** — Teams represent the grouping system used for Users. These are usually called groups, teams, agent groups, etc. in the underlying products. A User can belong to one or more Teams. - **Ticket Priorities** — Ticket Priorities represent the intended order in which the Tickets should be worked on. Some products provide customizing the Ticket Priorities. - **Ticket Status** — Ticket Status represents the completion level of the Ticket. Some products provide customizing the Ticket Status. - **Tickets** — Core resource which represents some work that needs to be carried out. Tickets are usually mapped to issues, tasks, work items, etc. depending on the underlying product. - **Users** — Users represent the people using the underlying ticketing system. They are usually called agents, team members, admins, etc. ## MCP-ready AI tools Truto exposes 168 tools for Kustomer that AI agents can call directly. - **list_all_kustomer_me** — Get information about the current user in Kustomer. Returns id, type, attributes, relationships, and links fields in the response. - **list_all_kustomer_users** — Get users in Kustomer. Returns user type, id, attributes, relationships, and links for each user. - **get_single_kustomer_user_by_id** — Get user by id in Kustomer. Requires id. Returns user data including type, id, attributes, relationships, and links. - **update_a_kustomer_user_by_id** — Update a specific user by id in Kustomer. Requires id and fields such as displayName, avatarUrl, name, email, mobile, emailSignature, deleted, password, currentPassword, userType, roleGroups, and roles. Returns updated user data including type, id, attributes, relationships, and links. - **create_a_kustomer_user** — Create a new user in Kustomer with required parameters name and email. Returns user id, type, attributes, relationships, and links in the response. - **create_a_kustomer_customer** — Create a new customer in Kustomer. Requires customer details such as name, company, externalId, and contact information. Returns the created customer's id, type, attributes, relationships, and links. - **list_all_kustomer_customers** — Get all customers in Kustomer. Returns customer id, type, attributes, relationships, and links fields. - **get_single_kustomer_customer_by_id** — Get customer by id in Kustomer. Returns customer type, id, attributes, relationships, and links. - **update_a_kustomer_customer_by_id** — Update a customer by id in Kustomer. Requires id. Returns data object with type, id, attributes, relationships, and links fields reflecting the updated customer. - **delete_a_kustomer_customer_by_id** — Delete a customer by id in Kustomer. Returns no content on success. - **kustomer_customers_using_email** — Get customer by email in Kustomer. Requires email. Returns customer data including type, id, attributes, relationships, and links. - **kustomer_customers_using_external_id** — Get customer by external_id in Kustomer. Returns data object with type, id, attributes, relationships, and links fields. - **kustomer_customers_using_phone_number** — Get customer by phone number in Kustomer. Requires phone in E.164 format. Returns customer id, type, attributes, relationships, and links. - **kustomer_customers_bulk_delete** — Delete multiple customers by specifying a comma-separated list of customer ids in Kustomer. Returns data object with type, id, attributes, relationships, and links fields. - **kustomer_customers_bulk_create** — Create customers in bulk in Kustomer. Returns data with id, type, attributes, relationships, and links for each created customer. - **kustomer_customers_bulk_update** — Update a bulk batch of customers in Kustomer using a comma-separated list of customer ids. Returns updated customer objects including id, type, attributes, relationships, and links. - **list_all_kustomer_conversations** — Get a paginated list of conversations in Kustomer. Returns conversation id, type, attributes, relationships, and links for each conversation. - **create_a_kustomer_conversation** — Create a new conversation in Kustomer with required parameter customer. Returns data including id, type, attributes, relationships, and links of the created conversation. Note rate limit of 120 conversations per minute per customer applies unless importedAt is specified. - **get_single_kustomer_conversation_by_id** — Get a single conversation by id in Kustomer. Returns the conversation's type, id, attributes, relationships, and links. - **update_a_kustomer_conversation_by_id** — Update a conversation by id in Kustomer. Returns the updated conversation object including key fields such as status, assignee, and custom attributes. Note: Subject to object rate limiting. - **delete_a_kustomer_conversation_by_id** — Delete a conversation by id in Kustomer. Returns no content on success. - **kustomer_conversations_bulk_create** — Create conversations in bulk in Kustomer. Requires providing conversation details including customer, and returns data with type, id, attributes, relationships, and links for each created conversation. - **kustomer_conversations_bulk_update** — Update a bulk batch of conversations in Kustomer using ids. Returns updated conversation objects including id, type, attributes, relationships, and links. - **kustomer_conversations_using_external_id** — Get a conversation by external ID in Kustomer. Returns conversation data including type, id, attributes, relationships, and links. - **list_all_kustomer_teams** — Get Teams for the Organization in Kustomer. Returns an array of team objects including id, type, attributes, relationships, and links. - **get_single_kustomer_team_by_id** — Get a Team by id in Kustomer. Returns the team's type, id, attributes, relationships, and links. - **create_a_kustomer_team** — Create a Team in Kustomer with required name. Returns the created team's id, type, attributes, relationships, and links. - **update_a_kustomer_team_by_id** — Update team by id in Kustomer. Requires id and name. Returns updated team data including type, id, attributes, relationships, and links. - **delete_a_kustomer_team_by_id** — Delete a team by id in Kustomer. Returns no content on success. - **list_all_kustomer_companies** — Get all companies in Kustomer. Returns an array of companies with fields type, id, attributes, relationships, and links. - **get_single_kustomer_company_by_id** — Get company by id in Kustomer. Returns company type, id, attributes, relationships, and links fields in the response. - **create_a_kustomer_company** — Create a new company in Kustomer with required name. Returns id, type, attributes, relationships, and links of the created company. - **update_a_kustomer_company_by_id** — Update company attributes by id in Kustomer. Returns updated company data including type, id, attributes, relationships, and links. - **kustomer_companies_bulk_create** — Create companies in bulk in Kustomer. Returns data with type, id, attributes, relationships, and links for each created company. - **kustomer_companies_bulk_update** — Batch update multiple companies in Kustomer. Returns updated company data with type, id, attributes, relationships, and links. - **list_all_kustomer_notes** — Get all notes for a Kustomer organization. Returns an array of notes with fields id, type, attributes, relationships, and links. - **get_single_kustomer_note_by_id** — Get a note by id in Kustomer. Returns the note's type, id, attributes, relationships, and links. - **create_a_kustomer_note** — Create a note in Kustomer with a required body parameter. Returns the note's id, type, attributes, relationships, and links in the response. - **update_a_kustomer_note_by_id** — Update a note by id in Kustomer. Requires id and conversation, body parameters. Returns updated note with type, id, attributes, relationships, and links. - **delete_a_kustomer_note_by_id** — Delete note by id in Kustomer. Requires the unique note id. Returns no content on success. - **kustomer_notes_update_note_attributes** — Update note attributes by id in Kustomer. Returns updated note with fields type, id, attributes, relationships, and links. - **kustomer_notes_bulk_create** — Create a bulk batch of notes in Kustomer. Requires body parameters conversation and body. Returns data with type, id, attributes, relationships, and links fields. - **kustomer_notes_bulk_update** — Update a bulk batch of notes in Kustomer using ids. Returns updated note data including type, id, attributes, relationships, and links. - **create_a_kustomer_conversation_note** — Create a new note within a conversation in Kustomer using the conversation ID. Returns data including type, id, attributes, relationships, and links of the created note. - **list_all_kustomer_conversation_notes** — Get notes by conversation id in Kustomer. Returns an array of notes with fields type, id, attributes, relationships, and links. - **get_single_kustomer_attachment_by_id** — Get attachment by id in Kustomer. Returns id, type, attributes (name, contentType, contentLength, uploaded, redacted), relationships (org id), links (self, related), and meta upload info. - **create_a_kustomer_attachment** — Create a new attachment in Kustomer with required parameters name, contentType, and contentLength. Returns attachment id, type, attributes, relationships, links, and upload policy including upload URL and fields for file upload. - **update_a_kustomer_attachment_by_id** — Update or upsert attachment by id in Kustomer. Returns id, type, attributes, relationships, links, meta, and upload details of the attachment. - **list_all_kustomer_messages** — Get messages for your Kustomer organization. Returns message id, type, attributes, relationships, and links. Supports sorting and including attachments. - **get_single_kustomer_message_by_id** — Get a single message by id in Kustomer. Returns the message's type, id, attributes, relationships, and links. - **create_a_kustomer_message** — Create a message in Kustomer by adding it to an existing conversation timeline. Requires conversation, type, channel, direction, and app. Returns message id, type, attributes, relationships, and links. - **update_a_kustomer_message_by_id** — Update a message by id in Kustomer. Returns the updated message object including fields such as createdAt, createdBy, modifiedAt, and modifiedBy. - **kustomer_messages_redact** — Redact a message by id in Kustomer. Returns the message id, type, attributes, and relationships in the response. - **kustomer_messages_message_using_external_id** — Get a message by externalId in Kustomer. Returns id, type, attributes, relationships, and links of the message. - **kustomer_messages_bulk_create** — Create a bulk batch of messages in Kustomer. Requires message, type, channel, and app fields. Returns data with id, type, attributes, relationships, and links for each created message. - **kustomer_messages_bulk_update** — Update a bulk batch of messages using ids in Kustomer. Returns updated messages with id, type, attributes, relationships, and links fields. - **get_single_kustomer_message_attachment_by_id** — Get attachment by message_id and id in Kustomer. Returns id, type, attributes (name, contentType, contentLength, redacted), relationships (org, message), and links (self, related). - **list_all_kustomer_tags** — Returns all tags in the Kustomer account. - **get_single_kustomer_tag_by_id** — Return the tag by id in the Kustomer account. - **list_all_kustomer_custom_objects** — Get KObject (custom object) by Klass name in Kustomer. Requires name as id. Returns fields type, id, attributes, relationships, and links including self, first, prev, and next URLs. - **get_single_kustomer_custom_object_by_id** — Get KObject (custom object) by its klass name and id in Kustomer. Returns type, id, attributes, relationships, and links of the KObject. - **delete_a_kustomer_custom_object_by_id** — Delete a KObject (custom object) by name and id in Kustomer. Returns no content on success. - **create_a_kustomer_custom_object** — Create a new KObject (custom object) in Kustomer with the klass name. Returns the created object's type, id, attributes, relationships, and links. - **update_a_kustomer_custom_object_by_id** — Update a KObject (custom object) by klass name and id in Kustomer. Returns the updated object's type, id, attributes, relationships, and links. Note: Subject to object rate limiting. - **kustomer_custom_objects_using_external_id** — Get KObject by klass name and external_id in Kustomer. Returns data including type, id, attributes, relationships, and links. - **kustomer_custom_objects_bulk_create** — Create KObjects (custom objects) in bulk in Kustomer with klass name. Returns data including type, id, attributes, relationships, and links for each created object. - **kustomer_custom_objects_bulk_update** — Update a bulk batch of multiple KObjects (custom objects) in Kustomer using the klass name and ids. Returns updated KObjects with fields type, id, attributes, relationships, and links. - **kustomer_custom_objects_bulk_delete** — Delete multiple KObjects (custom objects) by klass name and a comma-separated list of KObject ids in Kustomer. Returns the deleted objects with type, id, attributes, relationships, and links. - **list_all_kustomer_auth_roles** — Get available organization roles in Kustomer. Returns a list of roles with their id and name. - **list_all_kustomer_custom_attributes** — Get custom attribute metadata for a specific resource in Kustomer. Requires resource parameter with valid values: company, conversation, customer, message, or kobject.*. Returns type, id, attributes, relationships, and links fields. - **update_a_kustomer_custom_attribute_by_id** — Update custom attribute metadata for a specified resource in Kustomer. Requires resource. Returns data with type, id, attributes, relationships, and links. - **list_all_kustomer_klasses** — Get all Klasses in Kustomer. Returns id, type, attributes, relationships, and links for each Klass. - **get_single_kustomer_klass_by_id** — Get Klass by id in Kustomer. Returns data object with type, id, attributes, relationships, and links fields. - **delete_a_kustomer_klass_by_id** — Delete a Klass by id in Kustomer. Cannot delete if KObjects exist for the Klass. - **create_a_kustomer_klass** — Create a new Klass model in Kustomer with required name. Returns data including id, type, attributes, relationships, and links. - **update_a_kustomer_klass_by_id** — Update Klass attributes by id in Kustomer. Returns updated Klass with fields type, id, attributes, relationships, and links. - **list_all_kustomer_conversation_messages** — Get messages for a conversation in Kustomer by conversation id. Returns message id, type, attributes, relationships, and links. - **create_a_kustomer_conversation_message** — Create a new message from a conversation in Kustomer using conversation id. Returns message id, type, attributes, relationships, and links in the response. - **list_all_kustomer_customer_messages** — Get messages for a specific customer in Kustomer by contact id. Returns message type, id, attributes, relationships, and links. - **create_a_kustomer_customer_message** — Create a new message for a customer in Kustomer using the customer id. Returns message id, type, attributes, relationships, and links. If a conversation is specified, links the message to it; otherwise, creates a new conversation. - **list_all_kustomer_customer_notes** — Get notes for a specific customer in Kustomer. Returns note id, type, attributes, relationships, and links including self, first, prev, and next. - **list_all_kustomer_conversation_attachments** — Get conversation attachments by conversation id in Kustomer. Returns a paginated list of attachments shared via inbound and outbound messages with fields id, type, attributes, relationships, and links. - **kustomer_conversation_attachments_download** — Downloads a specific attachment file using the file's direct path, which is typically provided in the response of the message listing endpoint. The actual path must be replaced with the URI or download link of the attachment. - **list_all_kustomer_search_conversations** — Lists conversations in Kustomer sorted by their last updated time. Each conversation includes detailed metadata, message history, sentiment, and related entities like users, customers, SLAs, queues, and brands. - **list_all_kustomer_audit_logs** — Get audit logs for your organization in Kustomer. Returns id, type, attributes, relationships, and links for each audit log event. Supports filtering by objectType, objectId, userId, and date range. - **list_all_kustomer_brands** — Get a list of all brands in Kustomer. Returns brand id, type, attributes, relationships, and links. Supports page and pageSize query parameters. - **get_single_kustomer_brand_by_id** — Get brand by id in Kustomer. Returns brand's type, id, attributes, relationships, and links fields. - **create_a_kustomer_brand** — Create a brand with name and iconUrl in Kustomer. Returns the brand's id, type, attributes, relationships, and links. - **update_a_kustomer_brand_by_id** — Update brand with id in Kustomer. Requires name and iconUrl. Returns updated brand with type, id, attributes, relationships, and links. - **kustomer_brands_default** — Get the default brand created for your Kustomer organization. Returns id, type, attributes, relationships, and links of the default brand. - **get_single_kustomer_bulk_operation_by_id** — Get bulk operation by id in Kustomer. Returns status, completedAt timestamp, batches.complete and batches.total counts. Use this to check bulk operation status and details. - **list_all_kustomer_bulk_operation_batches** — Get detailed batch information for a specific bulk operation in Kustomer using bulk_id. Returns objectIds, successCount, failureCount, completedAt, and errors for each batch. - **list_all_kustomer_schedules** — Get all business schedules in Kustomer. Returns an array of schedules with fields type, id, attributes, relationships, and links. - **get_single_kustomer_schedule_by_id** — Get business schedule by id in Kustomer. Returns schedule id, type, attributes, relationships, and links. Optionally includes holidays if specified. - **create_a_kustomer_schedule** — Create a new business schedule in Kustomer with required parameters name, hours, timezone, and default. Returns data including type, id, attributes, relationships, and links. - **update_a_kustomer_schedule_by_id** — Update business schedule by id in Kustomer. Requires id, name (≤256 chars), hours (object with day index keys and hour tuples as values), timezone, and default (boolean). Returns updated schedule with type, id, attributes, relationships, and links. - **delete_a_kustomer_schedule_by_id** — Delete a business schedule by id in Kustomer. Returns the deleted schedule's type, id, attributes, relationships, and links. - **list_all_kustomer_default_schedules** — Get default business schedules in Kustomer. Returns schedule id, type, attributes, relationships, and links. - **list_all_kustomer_company_klasses** — Get all KObjects (custom Objects) linked to a company in Kustomer by company id and Klass name. Returns type, id, attributes, relationships, and links for each KObject. - **list_all_kustomer_conversation_events** — Get a paginated list of conversation events for a conversation by id in Kustomer. Returns event id, type, attributes, relationships, and links. Supports filtering by name and changed parameters. - **list_all_kustomer_conversation_forwards** — Get all forwards by conversation id in Kustomer. Returns id, type, attributes, relationships of each forward. - **create_a_kustomer_conversation_forward** — Create a forward for a conversation in Kustomer using id. Returns id, type, attributes, and relationships of the created forward. Use sendAt to schedule delivery. - **create_a_kustomer_conversation_tag** — Append tags to a conversation by id in Kustomer. Returns the updated conversation data including type, id, attributes, relationships, and links. - **delete_a_kustomer_conversation_tag_by_id** — Remove tags from a conversation by id in Kustomer. Returns the updated conversation data including type, id, attributes, relationships, and links. - **list_all_kustomer_conversation_times** — Get conversation times by conversation id in Kustomer. Returns an array of conversation_time objects including type, id, attributes, relationships, and links. - **get_single_kustomer_conversation_time_by_id** — Get conversation times by ids in Kustomer. Requires ids. Returns data with type, id, attributes, relationships, and links fields. - **list_all_kustomer_customer_drafts** — Get all outbound drafts for a customer by id in Kustomer. Returns draft id, type, attributes, relationships, and links including self, first, prev, and next. - **list_all_kustomer_customer_sessions** — Get all customer sessions for a specific customer in Kustomer. Requires id. Returns session id, type, attributes, relationships, and links. - **list_all_kustomer_customer_events** — Get all tracking events for a specific customer session in Kustomer using customer_id and session_id. Returns event id, type, attributes, relationships, and links. - **get_single_kustomer_customer_event_by_id** — Get a single customer event by customer_id and id in Kustomer. Returns data including type, id, attributes, relationships, and links. - **list_all_kustomer_customer_conversations** — Get a list of conversations for a customer in Kustomer using customer id. Returns conversation type, id, attributes, relationships, and links. - **create_a_kustomer_customer_conversation** — Create a new empty conversation for a customer in Kustomer using the customer id. Returns conversation id, type, attributes, relationships, and links. - **list_all_kustomer_customer_klasses** — Get all KObjects (custom objects) linked to a customer by name in Kustomer. Returns type, id, attributes, relationships, and links for each KObject. - **create_a_kustomer_customer_klass** — Create a new KObject (custom object) linked to a customer in Kustomer using customer id and klass name. Returns the created object's type, id, attributes, relationships, and links. - **list_all_kustomer_customer_merges** — Get customer merges by customer id in Kustomer. Returns an array of merges with fields type, id, attributes, relationships, and links. - **get_single_kustomer_customer_merge_by_id** — Get customer merge by id in Kustomer. Returns type, id, attributes, relationships, and links of the customer merge. - **create_a_kustomer_customer_merge** — Create a customer merge with source and target customer IDs in Kustomer. Returns merged customer data including type, id, attributes, relationships, and links. - **create_a_kustomer_customer_unmasking_window** — Create or replace an unmasking window for a customer by id in Kustomer. This allows sensitive attributes for the customer and related conversations, messages, and custom objects to be returned unmasked during the window period. - **delete_a_kustomer_customer_unmasking_window_by_id** — Delete unmasking window by customer id in Kustomer. Deleting the window masks sensitive attributes for the customer and related conversations, messages, and custom objects. - **list_all_kustomer_outbound_accounts** — Get all outbound accounts in Kustomer. Returns an array of outbound account objects including type, attributes, and links. - **delete_a_kustomer_draft_by_id** — Delete a draft by id in Kustomer. Returns no content on success. - **get_single_kustomer_draft_forward_by_id** — Get draft forward by id in Kustomer. Returns id, type, attributes, and relationships of the draft forward. - **update_a_kustomer_draft_forward_by_id** — Update a draft forward by id in Kustomer. Requires id and body parameters such as from, to, subject, body, status, sendAt, template, and attachments. Returns updated forward with id, type, attributes, and relationships. - **list_all_kustomer_draft_attachments** — Get all draft attachments for a draft using id in Kustomer. Returns attachment id, type, attributes, relationships, and links. - **get_single_kustomer_draft_attachment_by_id** — Get draft attachment by id in Kustomer. Returns id, type, attributes, relationships, and links including a pre-signed URL for downloading the attachment file. - **create_a_kustomer_draft_attachment** — Create an attachment on a draft in Kustomer using draft id. Returns attachment id, type, attributes, relationships, and links including a Pre-Signed URL for file upload. - **delete_a_kustomer_draft_attachment_by_id** — Delete draft attachment with id and draft_id in Kustomer. - **get_single_kustomer_media_by_id** — Get media object by id in Kustomer. Returns id, type, attributes, relationships, links, meta, provider, and upload fields for the specified media object(s). - **create_a_kustomer_media** — Create a new media upload document in Kustomer with required parameters name, contentType, and contentLength (≤ 10048576). Returns media id, type, attributes, relationships, links, meta, provider, and upload details including a temporary upload policy. - **update_a_kustomer_media_by_id** — Update media by id in Kustomer. Requires id. Returns updated media fields including id, type, attributes, relationships, links, meta, provider, and upload. - **list_all_kustomer_satisfactions** — Get a list of satisfaction forms in Kustomer. Returns id, type, attributes, relationships, and links for each satisfaction form. Requires page and pageSize parameters for pagination. - **kustomer_search_customers_search_archive_customers** — Create customer archive search with criteria in Kustomer. Requires search criteria in body. Returns data array with type, id, attributes, relationships, and links fields for each matched customer archive record. - **kustomer_search_customers_search** — Create customer search with criteria in Kustomer. Returns data array with customer objects including type, id, attributes, relationships, and links. Supports filtering on standard and custom attributes, sorting, and date filters. - **get_single_kustomer_sla_by_id** — Get SLA by id in Kustomer. Returns SLA type, id, attributes, relationships, and included related objects. Use versions query param to retrieve all or active SLA versions. - **list_all_kustomer_spam_senders** — Get a list of spam senders in Kustomer. Returns fields id, type, attributes, and relationships for each sender. - **delete_a_kustomer_spam_sender_by_id** — Delete a spam sender by id in Kustomer. Returns 204 on success. - **kustomer_spam_senders_upsert** — Upsert spam sender assigning a spam list status 'whitelist' or 'blacklist' in Kustomer. Returns id, type, attributes, and relationships of the spam sender. - **create_a_kustomer_tracking_event** — Create a new tracking event in Kustomer with required parameter name and optional trackingId, sessionId, and meta. Returns no content on success. - **create_a_kustomer_tracking_identity** — Create tracking identity with parameters like trackingId, sessionId, name, company, externalId, username, signedUpAt, birthdayAt, gender, locale, timeZone, email, phone, location, and tags in Kustomer. Returns id, type, attributes, relationships, and links. - **create_a_kustomer_identity_event** — Create tracking identity and track event in Kustomer. Requires identity object with user details and event object with event name. Returns data with type, id, attributes, relationships, and links. - **list_all_kustomer_forward_attachments** — Get all forward attachments for a specific forward in Kustomer. Requires id. Returns attachment id, type, attributes, relationships, and links. - **get_single_kustomer_forward_attachment_by_id** — Get forward attachment by id and attachmentId in Kustomer. Returns id, type, attributes, relationships, and links including a pre-signed URL for downloading the attachment file. - **delete_a_kustomer_forward_attachment_by_id** — Delete a forward attachment by id in Kustomer. Requires id and attachment_id. Returns no content on success. - **create_a_kustomer_forward_attachment** — Create an attachment on a forward in Kustomer using forward_id. Returns id, type, attributes, relationships, and links including a Pre-Signed URL for uploading the attachment content. - **create_a_kustomer_email_draft** — Create email draft for a customer in Kustomer. Requires customer_id. Returns id, channel, to, subject, sendAt, and status fields. - **update_a_kustomer_email_draft_by_id** — Update email draft by id in Kustomer. Returns id, channel, body, status, createdAt, updatedAt, modifiedAt. - **create_a_kustomer_customer_sms_draft** — Create SMS draft for a specific customer in Kustomer. Requires customer_id. Returns draft id, channel, body, and sendAt. - **update_a_kustomer_customer_sms_draft_by_id** — Update sms draft by id in Kustomer. Returns id, channel, body, status, createdAt, updatedAt, modifiedAt. - **create_a_kustomer_customer_chat_draft** — Create a chat draft for a specific customer in Kustomer using customer_id. Returns id, channel, body, and sendAt to confirm draft details. - **update_a_kustomer_customer_chat_draft_by_id** — Update chat draft by id in Kustomer. Returns id, channel, body, status, createdAt, updatedAt, modifiedAt. - **create_a_kustomer_customer_facebook_draft** — Create a Facebook draft for a customer in Kustomer. Requires customer_id. Returns id, channel, body, sendAt and createdAt fields. - **update_a_kustomer_customer_facebook_draft_by_id** — Update the Facebook draft by id in Kustomer. Returns id, channel, body, status, createdAt, updatedAt, modifiedAt. - **create_a_kustomer_customer_note_draft** — Create note draft for a customer in Kustomer using customer_id. Returns draft id, channel, body, sendAt, source, and conversation fields. - **update_a_kustomer_customer_note_draft_by_id** — Update the note draft by id in Kustomer. Returns id, channel, body, status, createdAt, updatedAt, modifiedAt. - **create_a_kustomer_customer_instagram_draft** — Create Instagram draft for customer id in Kustomer. Requires customer_id. Returns draft id, channel, body, sendAt, auto and source fields. Limited to 120 drafts per minute per customer. - **update_a_kustomer_customer_instagram_draft_by_id** — Update an Instagram draft by id in Kustomer. Returns id, channel, body, status, createdAt, updatedAt, modifiedAt. - **create_a_kustomer_customer_twitter_tweet_draft** — Create a Twitter tweet draft for the customer in Kustomer. Requires customer_id. Returns id, channel, body, sendAt, and conversation fields. - **update_a_kustomer_customer_twitter_tweet_draft_by_id** — Update the Twitter tweet draft by id in Kustomer. Returns id, channel, body, status, createdAt, updatedAt, modifiedAt. - **create_a_kustomer_customer_twitter_dm_draft** — Create customer Twitter DM draft in Kustomer using customer_id. Returns id, channel, body, and sendAt of the created draft. Limited to 120 drafts per minute per customer. - **update_a_kustomer_customer_twitter_dm_draft_by_id** — Update the Twitter dm draft by id in Kustomer. Returns id, channel, body, status, createdAt, updatedAt, modifiedAt. - **create_a_kustomer_customer_whatsapp_basic_draft** — Create WhatsApp basic draft for a customer in Kustomer. Requires customer_id. Returns id, channel, to, from, body, and sendAt fields describing the created draft. - **update_a_kustomer_customer_whatsapp_basic_draft_by_id** — Update the WhatsApp draft by id in Kustomer. Returns id, channel, body, status, createdAt, updatedAt, modifiedAt. - **create_a_kustomer_customer_whatsapp_interactive_draft** — Create WhatsApp interactive draft for a customer in Kustomer using id. Returns id, channel, status, createdAt, updatedAt, modifiedAt. - **list_all_kustomer_shortcuts** — List all shortcuts in Kustomer. Returns id, type, attributes (name, draft text, createdAt, modifiedAt, updatedAt), relationships (org, createdBy, modifiedBy), and links for each shortcut. - **get_single_kustomer_shortcut_by_id** — Get a shortcut by id in Kustomer. Returns fields such as name, draft.text, createdAt, modifiedAt, updatedAt, and relationships including org, createdBy, and modifiedBy. - **create_a_kustomer_shortcut** — Create a new shortcut in Kustomer. Returns id, type, attributes (name, draft.text, createdAt, modifiedAt, updatedAt), relationships (org, createdBy, modifiedBy, parent), and links.self in the response. - **update_a_kustomer_shortcut_by_id** — Update a shortcut in Kustomer using id. Returns id, type, attributes (name, draft.text, createdAt, modifiedAt, updatedAt), relationships (org, createdBy, modifiedBy, parent), and links.self. - **delete_a_kustomer_shortcut_by_id** — Delete a shortcut in Kustomer using the required id. Returns no content in the response upon successful deletion. ## How it works 1. **Link your customer's Kustomer account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Kustomer.** The Proxy API is a 1-to-1 mapping of the Kustomer API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync post-purchase data into Kustomer's agent workspace** — E-commerce logistics and returns platforms can define custom Klasses and push shipment or return status updates as Custom Objects, giving support agents real-time order context without leaving Kustomer. This reduces average handle time and eliminates tab-switching. - **Power AI copilots that draft omnichannel replies** — AI support platforms can read incoming conversations and messages via Truto, run intent classification and response generation, then push channel-specific drafts (email, WhatsApp, Instagram, SMS, chat) back into Kustomer for agent review and approval. - **Feed real-time product events into the customer timeline** — CDPs and product analytics tools can stream frontend events like checkout failures or subscription cancellations into Kustomer via tracking events and identity APIs, so agents see full behavioral context before the customer even describes their issue. - **Build QA and coaching workflows on top of Kustomer conversations** — Quality assurance platforms can continuously pull agents, conversations, and messages to score interactions, then push evaluation summaries back as internal conversation notes — closing the feedback loop directly inside the agent's workspace. - **Unify customer identity across systems to prevent duplicates** — Master data management and CDP tools can leverage customer search, identity events, and customer merge APIs to deduplicate records in Kustomer, ensuring agents always see a single, clean customer timeline. ## What you can build - **Custom Object timeline injection** — Define Klasses and bulk-create or update Custom Objects tied to customers, surfacing domain-specific data like subscriptions, shipments, or billing events directly in Kustomer's Insight Panel. - **Omnichannel AI draft queue** — Generate and push AI-written reply drafts across email, WhatsApp, Instagram, Facebook, SMS, Twitter, and chat channels, letting agents approve or edit before sending. - **Two-way conversation and ticket sync** — Use the Unified Ticketing API to read and write Kustomer conversations, messages, contacts, tags, and teams from a normalized schema shared across helpdesk platforms. - **Agent directory and role sync** — Pull Kustomer users, teams, and auth roles via the Unified User Directory API to keep your SaaS product's permission model aligned with your customers' Kustomer workspace. - **Behavioral event streaming to customer timelines** — Push tracking events and identity events from your product analytics or CDP into Kustomer so agents see real-time user actions like page views, cart abandonment, or feature usage. - **Automated conversation tagging and routing** — Apply tags to conversations programmatically and update conversation assignments or statuses to power triage automation built in your own product. ## FAQs ### What authentication method does the Kustomer integration use? Kustomer uses API key-based authentication. Your end users generate an API key from their Kustomer admin settings, and Truto securely stores and manages it so you never handle raw credentials. ### Can I read and write custom data schemas (Klasses and KObjects)? Yes. Truto supports full CRUD on Klasses (create, list, get, update, delete) and Custom Objects (create, list, get, update, delete), including bulk create, bulk update, and bulk delete operations and lookup by external ID. ### Which Unified APIs map to Kustomer resources? Truto maps Kustomer to the Unified User Directory API (Users, Roles) and the Unified Ticketing API (Tickets/Conversations, Comments/Messages, Contacts/Customers, Attachments, Tags, Teams, Fields, Users, Ticket Priorities, Ticket Status, Accounts/Companies). This lets you use a single normalized schema across multiple helpdesk integrations. ### Does the integration support bulk operations? Yes. Kustomer's bulk endpoints are fully supported for customers, conversations, messages, notes, custom objects, and companies — covering bulk create, bulk update, and in some cases bulk delete. You can also check bulk operation status and list batches. ### Can I search for customers by email, phone, or external ID? Yes. Dedicated lookup endpoints exist for customers by email, phone number, and external ID. There are also full customer search and archive search endpoints for more advanced queries. ### Are omnichannel draft APIs available for all messaging channels? Truto exposes Kustomer's channel-specific draft APIs for email, SMS, chat, Facebook, Instagram, Twitter (tweet and DM), WhatsApp basic, and WhatsApp interactive messages — each with create and update operations.