Plain integration

Fetch company

Tool to fetch company details by id. use when you need the full profile of a company, including name, domain, contract value, owner info, and timestamps.

Fetch issues

Tool to fetch external issue links for a customer. use when you need to list all issues across a customer's threads.

Fetch tier

Tool to fetch a tier by its id. use when you have a tier id and need its metadata before proceeding. example: "fetch tier with id tier 123".

Get customer by email

Tool to fetch customer details by email. use after confirming the email exists to retrieve detailed customer information.

Get customer by id

Tool to retrieve details of a specific customer by their unique id. use after obtaining the customer's id to fetch their complete record.

Get customers

Tool to fetch a list of customers. use when retrieving multiple customer records with pagination, filtering, or sorting.

Get thread by id

Tool to fetch details of a specific thread using its unique identifier. use after confirming the thread id is correct.

Get user by id

Tool to fetch user by id. use when you have a valid user id to retrieve detailed user information.

List threads

Tool to list all threads. use when you need to retrieve thread summaries with optional pagination.

List tiers

Tool to retrieve a list of tiers with pagination. use when you need to browse available tiers after determining pagination cursors. example: 'list tiers with first=25'.

List customer groups

Tool to list all customer groups. use when you need to retrieve group metadata with optional pagination or filters.

Query threads

Tool to retrieve a paginated list of threads. use when you need to list threads with optional status filtering.

Add customer to group

Tool to add a customer to one or more customer groups. use when you have a customer and groups ready.

Create customer

Tool to create a customer. use after gathering email and full name to provision a new customer in plain.

Create thread

Tool to create a new thread. use after obtaining valid customer identifier.

Delete customer

Tool to delete a customer from the system. use when you need to remove a customer by their id.

Delete user

Tool to delete a user from the system. use when you need to remove a user by their id after confirming existence.

Create customer group

Tool to create a new customer group. use when needing to group customers for segmentation. creates a new customer group with specified name, key, color, and optional externalid.

Remove customer from group

Tool to remove a customer from one or more customer groups. use when you need to revoke memberships.

Send message

Tool to send a new message within a thread. use after identifying the thread and preparing message content.

Update company

Tool to update an existing company's details. use when modifying a company's name or domain.

Update thread

Tool to update a thread's title. use when renaming a thread after confirming its id.

Upsert customer

Tool to upsert (create or update) a customer. use when syncing or ensuring a customer record exists before subsequent actions.