Skip to main content
Kustomer
Betav1.0.0
53 actions · 2 auth methods
Ticketing

Getting Started

1

Create or Select a Project

Set up a new project or select an existing one. See Organizations & Projects.
2

Configure the Connector

Enable the connector and set up a Connector Profile in your project. See Setup Connector Profile.

Connector Profile · OAuth 2.0

Connect using OAuth 2.0 authorization code flow. Requires registering a Kustomer app via the Apps Platform API.

Connector Profile · API Key

Authenticate using a Kustomer API key with Bearer token authorization.
3

Link an Account

Link an account from the dashboard (or via StackOne Hub).See the guide for the authentication type chosen in the Connector Profile:

Link Account · OAuth 2.0

Link Account · API Key

4

Use Actions

Connect your agent to the linked account’s actions. See Agent Setup.Other ways to call actions are listed in Protocols & SDKs.

Actions

|
53 actions
Action
Description
List Customers
Retrieve a paginated list of customers
Get Customer By ID
Retrieve a single customer by ID
Create Customer
Create a new customer
Update Customer
Update an existing customer by ID (full replacement)
Update Customer Attributes
Partially update a customer’s attributes by ID
Delete Customer
Delete a customer by ID
List Conversations
Retrieve a paginated list of conversations
Get Conversation By ID
Retrieve a single conversation by ID
Create Conversation
Create a new conversation associated with an existing customer
Update Conversation
Update a conversation by replacing its fields (PUT semantics)
Update Conversation Attributes
Partially update a conversation’s attributes using PATCH semantics
Delete Conversation
Delete a conversation by ID
List Messages
Retrieve a paginated list of messages
Get Message By ID
Retrieve a single message by ID
Create Message
Create a new message. Requires channel, app (channel integration identifier — not a Kustomer ID), and direction. Use lis…
Update Message By ID
Replace a message by ID using full PUT semantics (replaces entire resource; use update_message_attributes_by_id for part…
Update Message Attributes By ID
Partially update message attributes by ID
Get Users
Retrieve a paginated list of org users
Get User By ID
Retrieve a single user by their unique ID
Get Multiple Users By IDs
Retrieve multiple users by a comma-separated list of IDs
Create / Invite New User
Create an account for a new org user and send an invitation email
Update User By ID
Update an existing org user’s profile or account settings
List Notes
Retrieve a paginated list of notes
Get Note By ID
Retrieve a single note by ID
Create Note
Create a new note
Update Note By ID
Replace a note by ID
Update Note Attributes By ID
Partially update note attributes by ID
Delete Note By ID
Delete a note by ID
Get Klasses
Retrieve a paginated list of klasses
Get Klass By ID
Retrieve a single klass by ID
Create Klass
Create a new klass
Update Klass By ID
Update an existing klass by ID
Delete Klass
Delete a klass by ID
Get KObjects (custom Objects)
Retrieve a paginated list of kobjects for a klass. Use list_klasses first to get the klass name (slug) required as a pat…
Get KObject (custom Object) By ID
Retrieve a single kobject by klass name and ID. Use list_klasses to get the klass name and get_kobjects to get the kobje…
Create KObject
Create a new kobject (custom object instance) within a klass. Use list_klasses to get the klass name (slug) required as…
Update KObject (custom Object) By ID
Update an existing kobject by klass name and ID. Use list_klasses to get the klass name and get_kobjects to get the kobj…
Delete KObject (custom Object) By ID
Delete a kobject by klass name and ID. Use list_klasses to get the klass name and get_kobjects to get the kobject ID.
Get Companies
Retrieve a paginated list of companies
Get Company By ID
Retrieve a single company by its unique ID
Create Company
Create a new company
Update Company Attributes
Update an existing company by ID
Get Sub-statuses
Retrieve a paginated list of sub-statuses
Create Sub-status
Create a new sub-status
Get Sub-Status By ID
Retrieve a single sub-status by its unique ID
Update Sub-Status
Update an existing sub-status by ID
Delete Sub-Status
Delete a sub-status by ID
Bulk Create Conversations
Create multiple conversations in a single request
Bulk Batch Update Conversations
Update multiple conversations in a single request
Bulk Delete Conversations
Delete multiple conversations in a single request
Query Events Associated With Your Organization
Retrieve audit log events for your organization
Find Company KObjects (custom Objects)
Retrieve KObjects of a specific Klass associated with a company. Use list_companies to get the company ID and list_klass…
Find Customer KObjects (custom Objects)
Retrieve KObjects of a specific Klass associated with a customer. Use list_customers to get the customer ID and list_kla…