Plain
App · 20 actions
Run your Plain support desk from workflows: open, label, assign, snooze, close and reply to threads, keep customers and accounts in step with your own systems, add notes and set account tiers.
Actions
| Action | What it does |
|---|---|
| Add labels to thread | Put one or more labels on a thread. |
| Add note | Add an internal note to a customer, or to one of their threads. |
| Change thread status | Mark a thread done or to do, or snooze it until a time. |
| Create or update account | Add an account (a company you support), or update the one with this id of yours: its name and link. |
| Create or update customer | Add a customer, or update the one with this email address: their name, short name and your own id for them. |
| Create thread | Open a support thread for a customer, with a title, priority, labels and assignee. |
| Delete account | Delete an account. |
| Delete customer | Delete a customer for good, with their threads and notes. |
| Delete thread | Delete a thread for good, with its messages and notes. |
| Get customer | Find one customer by email address, Plain id or your own external id. |
| Get thread | Get one thread with its status, priority, customer, assignee, labels, account and tier. |
| List accounts | List the accounts (companies) your customers belong to, by name, optionally only those in one tier. |
| List customers | List customers by name, optionally only those changed since a time. |
| List labels | List the labels threads can be given in your workspace, with their ids and the group each is in. |
| List threads | List support threads, filtered by status, priority, customer, label or assignee. |
| List tiers | List your support tiers, which set the SLAs and default priority of the threads of the accounts in them. |
| Remove labels from thread | Take one or more labels off a thread. |
| Reply to thread | Send the customer a reply on the thread's own channel (email, chat, Slack or Teams), as the connected machine user. |
| Set account tier | Put an account in a support tier, in place of any tier it was in. |
| Update thread | Rename a thread, change its priority or assign it to a teammate. |
Add labels to thread
Put one or more labels on a thread.
Inputs
- Thread
thread_idtextRequired - The thread's id (th_...) or its reference such as T-123, from 'List threads' or an earlier step.
- Labels
label_type_idslistRequired - The labels to use. Pick one or more.
Outputs
labelslist- The labels added
threadobject- The thread
Example output
{
"labels": [
{
"id": "l_01HXAMPLELABEL",
"labelType": {
"id": "lt_01HXBUG",
"name": "Bug"
}
}
],
"thread": {
"account": {
"id": "acc_01HXACME",
"name": "Acme Inc"
},
"assignedTo": {
"email": "sam@yourcompany.com",
"fullName": "Sam Support",
"id": "u_01HXAMPLEUSER",
"type": "user"
},
"channel": "API",
"createdAt": "2026-10-15T09:00:00.000Z",
"customer": {
"email": "jo@example.com",
"fullName": "Jo Bloggs",
"id": "c_01HXAMPLECUSTOMER",
"isEmailVerified": false
},
"description": "The export button does nothing.",
"externalId": "ticket-77",
"id": "th_01HXAMPLETHREAD",
"labels": [
{
"id": "l_01HXAMPLELABEL",
"labelType": {
"id": "lt_01HXBUG",
"name": "Bug"
}
}
],
"previewText": "The export button does nothing.",
"priority": 1,
"priorityLabel": "High",
"ref": "T-1042",
"status": "TODO",
"statusChangedAt": "2026-10-15T09:00:00.000Z",
"tier": {
"id": "tier_01HXGOLD",
"name": "Gold"
},
"title": "Cannot export invoices",
"updatedAt": "2026-10-15T09:05:00.000Z"
}
}Add note
Add an internal note to a customer, or to one of their threads. Only your team sees it.
Inputs
- Customer
customertextRequired - The customer's email address, Plain id (c_...) or your own external id for them.
- Note
texttextRequired - The note. Markdown such as **bold** and links works.
- Thread
thread_idtext - Put the note on this thread of theirs (id or reference such as T-123). Leave empty to add it to the customer.
Outputs
noteobject- The note
Example output
{
"note": {
"createdAt": "2026-10-15T09:10:00.000Z",
"customerId": "c_01HXAMPLECUSTOMER",
"id": "n_01HXAMPLENOTE",
"markdown": "Called them about the export bug.",
"text": "Called them about the export bug.",
"threadId": "th_01HXAMPLETHREAD"
}
}Change thread status
Mark a thread done or to do, or snooze it until a time. Any new message moves it back to to do.
Inputs
- Thread
thread_idtextRequired - The thread's id (th_...) or its reference such as T-123, from 'List threads' or an earlier step.
- Status
statustextRequired - The thread's new status.One of:
TODO(To do),SNOOZED,DONE. - Snooze until
snooze_untildate and time - When the thread comes back to to do.Only when Status is Snoozed.
Outputs
threadobject- The thread
Example output
{
"thread": {
"account": {
"id": "acc_01HXACME",
"name": "Acme Inc"
},
"assignedTo": {
"email": "sam@yourcompany.com",
"fullName": "Sam Support",
"id": "u_01HXAMPLEUSER",
"type": "user"
},
"channel": "API",
"createdAt": "2026-10-15T09:00:00.000Z",
"customer": {
"email": "jo@example.com",
"fullName": "Jo Bloggs",
"id": "c_01HXAMPLECUSTOMER",
"isEmailVerified": false
},
"description": "The export button does nothing.",
"externalId": "ticket-77",
"id": "th_01HXAMPLETHREAD",
"labels": [
{
"id": "l_01HXAMPLELABEL",
"labelType": {
"id": "lt_01HXBUG",
"name": "Bug"
}
}
],
"previewText": "The export button does nothing.",
"priority": 1,
"priorityLabel": "High",
"ref": "T-1042",
"status": "DONE",
"statusChangedAt": "2026-10-15T09:00:00.000Z",
"tier": {
"id": "tier_01HXGOLD",
"name": "Gold"
},
"title": "Cannot export invoices",
"updatedAt": "2026-10-15T09:05:00.000Z"
}
}Create or update account
Add an account (a company you support), or update the one with this id of yours: its name and link.
Inputs
- Your id for it
external_idtextRequired - The account's id in your own systems, which finds it if it exists.
- Name
nametextRequired - The account's name, such as the company name.
- Link
urltext - A link to the account in your own product or admin.
Outputs
accountobject- The account
resulttext- CREATED, UPDATED or NOOP (nothing to change)
Example output
{
"account": {
"createdAt": "2026-10-01T09:00:00.000Z",
"externalId": "acme",
"id": "acc_01HXACME",
"name": "Acme Inc",
"primaryDomain": "acme.example.com",
"tier": {
"id": "tier_01HXGOLD",
"name": "Gold"
},
"updatedAt": "2026-10-15T09:00:00.000Z",
"url": "https://acme.example.com/admin"
},
"result": "CREATED"
}Create or update customer
Add a customer, or update the one with this email address: their name, short name and your own id for them. Plain does not email them.
Inputs
- Email
emailtextRequired - The customer's email address, which finds them if they exist.
- Full name
full_nametextRequired - The customer's full name.
- Short name
short_nametext - What to call them, usually their first name.
- Your id for them
external_idtext - The customer's id in your own systems.
- Account
account_idtext - The account (company) this belongs to in Plain.
Outputs
customerobject- The customer
resulttext- CREATED, UPDATED or NOOP (nothing to change)
Example output
{
"customer": {
"avatarUrl": "https://example.com/jo.png",
"createdAt": "2026-10-15T09:00:00.000Z",
"email": "jo@example.com",
"externalId": "cust-1001",
"fullName": "Jo Bloggs",
"id": "c_01HXAMPLECUSTOMER",
"isEmailVerified": false,
"markedAsSpamAt": "",
"shortName": "Jo",
"updatedAt": "2026-10-15T09:00:00.000Z"
},
"result": "CREATED"
}Create thread
Open a support thread for a customer, with a title, priority, labels and assignee. The customer is not messaged; use 'Reply to thread' to write to them.
Inputs
- Customer
customertextRequired - The customer's email address, Plain id (c_...) or your own external id for them.
- Title
titletextRequired - What the thread is about.
- Description
descriptiontext - More detail, shown as the thread's preview in Plain.
- Priority
prioritytext - How urgent the thread is. New threads are Normal unless set.One of:
0(Urgent),1(High),2(Normal),3(Low). - Labels
label_type_idslist - Labels to put on the thread.
- Assign to
assigned_to_user_idtext - The teammate to assign the thread to.
- Account
account_idtext - The account (company) this belongs to in Plain.
- Your id for it
external_idtext - The thread's id in your own systems, such as a ticket number.
Outputs
threadobject- The thread
Example output
{
"thread": {
"account": {
"id": "acc_01HXACME",
"name": "Acme Inc"
},
"assignedTo": {
"email": "sam@yourcompany.com",
"fullName": "Sam Support",
"id": "u_01HXAMPLEUSER",
"type": "user"
},
"channel": "API",
"createdAt": "2026-10-15T09:00:00.000Z",
"customer": {
"email": "jo@example.com",
"fullName": "Jo Bloggs",
"id": "c_01HXAMPLECUSTOMER",
"isEmailVerified": false
},
"description": "The export button does nothing.",
"externalId": "ticket-77",
"id": "th_01HXAMPLETHREAD",
"labels": [
{
"id": "l_01HXAMPLELABEL",
"labelType": {
"id": "lt_01HXBUG",
"name": "Bug"
}
}
],
"previewText": "The export button does nothing.",
"priority": 1,
"priorityLabel": "High",
"ref": "T-1042",
"status": "TODO",
"statusChangedAt": "2026-10-15T09:00:00.000Z",
"tier": {
"id": "tier_01HXGOLD",
"name": "Gold"
},
"title": "Cannot export invoices",
"updatedAt": "2026-10-15T09:05:00.000Z"
}
}Delete account
Delete an account. Its customers and threads stay, without it.
Inputs
- Account
account_idtextRequired - The account (company) in Plain.
Outputs
account_idtext- The account deleted
deletedtrue/false- Always true once deleted
Example output
{
"account_id": "acc_01HXACME",
"deleted": true
}Delete customer
Delete a customer for good, with their threads and notes.
Inputs
- Customer
customertextRequired - The customer's email address, Plain id (c_...) or your own external id for them.
Outputs
customer_idtext- The customer deleted
deletedtrue/false- Always true once deleted
Example output
{
"customer_id": "c_01HXAMPLECUSTOMER",
"deleted": true
}Delete thread
Delete a thread for good, with its messages and notes.
Inputs
- Thread
thread_idtextRequired - The thread's id (th_...) or its reference such as T-123, from 'List threads' or an earlier step.
Outputs
deletedtrue/false- Always true once deleted
thread_idtext- The thread deleted
Example output
{
"deleted": true,
"thread_id": "th_01HXAMPLETHREAD"
}Get customer
Find one customer by email address, Plain id or your own external id. Fails if there is none.
Inputs
- Customer
customertextRequired - The customer's email address, Plain id (c_...) or your own external id for them.
Outputs
customerobject- The customer
Example output
{
"customer": {
"avatarUrl": "https://example.com/jo.png",
"createdAt": "2026-10-15T09:00:00.000Z",
"email": "jo@example.com",
"externalId": "cust-1001",
"fullName": "Jo Bloggs",
"id": "c_01HXAMPLECUSTOMER",
"isEmailVerified": false,
"markedAsSpamAt": "",
"shortName": "Jo",
"updatedAt": "2026-10-15T09:00:00.000Z"
}
}Get thread
Get one thread with its status, priority, customer, assignee, labels, account and tier.
Inputs
- Thread
thread_idtextRequired - The thread's id (th_...) or its reference such as T-123, from 'List threads' or an earlier step.
Outputs
threadobject- The thread
Example output
{
"thread": {
"account": {
"id": "acc_01HXACME",
"name": "Acme Inc"
},
"assignedTo": {
"email": "sam@yourcompany.com",
"fullName": "Sam Support",
"id": "u_01HXAMPLEUSER",
"type": "user"
},
"channel": "API",
"createdAt": "2026-10-15T09:00:00.000Z",
"customer": {
"email": "jo@example.com",
"fullName": "Jo Bloggs",
"id": "c_01HXAMPLECUSTOMER",
"isEmailVerified": false
},
"description": "The export button does nothing.",
"externalId": "ticket-77",
"id": "th_01HXAMPLETHREAD",
"labels": [
{
"id": "l_01HXAMPLELABEL",
"labelType": {
"id": "lt_01HXBUG",
"name": "Bug"
}
}
],
"previewText": "The export button does nothing.",
"priority": 1,
"priorityLabel": "High",
"ref": "T-1042",
"status": "TODO",
"statusChangedAt": "2026-10-15T09:00:00.000Z",
"tier": {
"id": "tier_01HXGOLD",
"name": "Gold"
},
"title": "Cannot export invoices",
"updatedAt": "2026-10-15T09:05:00.000Z"
}
}List accounts
List the accounts (companies) your customers belong to, by name, optionally only those in one tier. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Tier
tier_idtext - Only accounts in this tier.
- Page size
page_sizenumber - How many to return, 1 to 100. Plain's default is 25.From 1 to 100.
- Next page cursor
aftertext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
accountslist- The accounts
countnumber- How many are on this page
has_next_pagetrue/false- Whether more follow
next_cursortext- Give this as 'Next page cursor' to get the next page; empty on the last
Example output
{
"accounts": [
{
"createdAt": "2026-10-01T09:00:00.000Z",
"externalId": "acme",
"id": "acc_01HXACME",
"name": "Acme Inc",
"primaryDomain": "acme.example.com",
"tier": {
"id": "tier_01HXGOLD",
"name": "Gold"
},
"updatedAt": "2026-10-15T09:00:00.000Z",
"url": "https://acme.example.com/admin"
}
],
"count": 1,
"has_next_page": false,
"next_cursor": ""
}List customers
List customers by name, optionally only those changed since a time. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Changed since
updated_sincedate and time - Only customers created or changed since this time.
- Page size
page_sizenumber - How many to return, 1 to 100. Plain's default is 25.From 1 to 100.
- Next page cursor
aftertext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many are on this page
customerslist- The customers
has_next_pagetrue/false- Whether more follow
next_cursortext- Give this as 'Next page cursor' to get the next page; empty on the last
total_countnumber- How many match in all
Example output
{
"count": 1,
"customers": [
{
"avatarUrl": "https://example.com/jo.png",
"createdAt": "2026-10-15T09:00:00.000Z",
"email": "jo@example.com",
"externalId": "cust-1001",
"fullName": "Jo Bloggs",
"id": "c_01HXAMPLECUSTOMER",
"isEmailVerified": false,
"markedAsSpamAt": "",
"shortName": "Jo",
"updatedAt": "2026-10-15T09:00:00.000Z"
}
],
"has_next_page": false,
"next_cursor": "",
"total_count": 1
}List labels
List the labels threads can be given in your workspace, with their ids and the group each is in.
Inputs
- Include archived
include_archivedtrue/false - Also list labels that have been archived.
Outputs
countnumber- How many
label_typeslist- The labels
Example output
{
"count": 1,
"label_types": [
{
"color": "#FF0000",
"description": "Something is broken",
"externalId": "bug",
"id": "lt_01HXBUG",
"isArchived": false,
"name": "Bug",
"parentLabelType": {
"id": "lt_01HXPRODUCT",
"name": "Product"
}
}
]
}List threads
List support threads, filtered by status, priority, customer, label or assignee. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Status
statuseslist - Only threads in these statuses. All when none is picked.One or more of:
TODO(To do),SNOOZED,DONE. - Priority
prioritieslist - Only threads of these priorities. All when none is picked.One or more of:
0(Urgent),1(High),2(Normal),3(Low). - Customer
customertext - Only this customer's threads: their email address, Plain id or your own id for them.
- Labels
label_type_idslist - Only threads with any of these labels.
- Assigned to
assigned_to_user_idtext - Only threads assigned to this teammate.
- Order
sorttext - How to order the threads. Defaults to newest first.One of:
newest(Newest first (default)),oldest(Oldest first),status_changed(Status changed most recently),priority(Most urgent first),last_message(Latest customer message first). Default:newest. - Page size
page_sizenumber - How many to return, 1 to 100. Plain's default is 25.From 1 to 100.
- Next page cursor
aftertext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many are on this page
has_next_pagetrue/false- Whether more follow
next_cursortext- Give this as 'Next page cursor' to get the next page; empty on the last
threadslist- The threads
total_countnumber- How many match in all
Example output
{
"count": 1,
"has_next_page": false,
"next_cursor": "",
"threads": [
{
"account": {
"id": "acc_01HXACME",
"name": "Acme Inc"
},
"assignedTo": {
"email": "sam@yourcompany.com",
"fullName": "Sam Support",
"id": "u_01HXAMPLEUSER",
"type": "user"
},
"channel": "API",
"createdAt": "2026-10-15T09:00:00.000Z",
"customer": {
"email": "jo@example.com",
"fullName": "Jo Bloggs",
"id": "c_01HXAMPLECUSTOMER",
"isEmailVerified": false
},
"description": "The export button does nothing.",
"externalId": "ticket-77",
"id": "th_01HXAMPLETHREAD",
"labels": [
{
"id": "l_01HXAMPLELABEL",
"labelType": {
"id": "lt_01HXBUG",
"name": "Bug"
}
}
],
"previewText": "The export button does nothing.",
"priority": 1,
"priorityLabel": "High",
"ref": "T-1042",
"status": "TODO",
"statusChangedAt": "2026-10-15T09:00:00.000Z",
"tier": {
"id": "tier_01HXGOLD",
"name": "Gold"
},
"title": "Cannot export invoices",
"updatedAt": "2026-10-15T09:05:00.000Z"
}
],
"total_count": 1
}List tiers
List your support tiers, which set the SLAs and default priority of the threads of the accounts in them.
Inputs
None.
Outputs
countnumber- How many
tierslist- The tiers
Example output
{
"count": 1,
"tiers": [
{
"color": "#FABADA",
"defaultThreadPriority": 1,
"externalId": "gold",
"id": "tier_01HXGOLD",
"isDefault": false,
"name": "Gold"
}
]
}Remove labels from thread
Take one or more labels off a thread. Labels the thread doesn't have are skipped.
Inputs
- Thread
thread_idtextRequired - The thread's id (th_...) or its reference such as T-123, from 'List threads' or an earlier step.
- Labels
label_type_idslistRequired - The labels to use. Pick one or more.
Outputs
removed_countnumber- How many were removed
threadobject- The thread
Example output
{
"removed_count": 1,
"thread": {
"account": {
"id": "acc_01HXACME",
"name": "Acme Inc"
},
"assignedTo": {
"email": "sam@yourcompany.com",
"fullName": "Sam Support",
"id": "u_01HXAMPLEUSER",
"type": "user"
},
"channel": "API",
"createdAt": "2026-10-15T09:00:00.000Z",
"customer": {
"email": "jo@example.com",
"fullName": "Jo Bloggs",
"id": "c_01HXAMPLECUSTOMER",
"isEmailVerified": false
},
"description": "The export button does nothing.",
"externalId": "ticket-77",
"id": "th_01HXAMPLETHREAD",
"labels": [],
"previewText": "The export button does nothing.",
"priority": 1,
"priorityLabel": "High",
"ref": "T-1042",
"status": "TODO",
"statusChangedAt": "2026-10-15T09:00:00.000Z",
"tier": {
"id": "tier_01HXGOLD",
"name": "Gold"
},
"title": "Cannot export invoices",
"updatedAt": "2026-10-15T09:05:00.000Z"
}
}Reply to thread
Send the customer a reply on the thread's own channel (email, chat, Slack or Teams), as the connected machine user. The customer receives it.
Inputs
- Thread
thread_idtextRequired - The thread's id (th_...) or its reference such as T-123, from 'List threads' or an earlier step.
- Message
messagetextRequired - The reply. Markdown such as **bold** and links works.
Outputs
senttrue/false- Always true once sent
thread_idtext- The thread replied to
Example output
{
"sent": true,
"thread_id": "th_01HXAMPLETHREAD"
}Set account tier
Put an account in a support tier, in place of any tier it was in.
Inputs
- Account
account_idtextRequired - The account (company) in Plain.
- Tier
tier_idtextRequired - The tier to put the account in.
Outputs
account_idtext- The account
membership_idtext- The id of the account's place in the tier
tier_idtext- The tier it is now in
Example output
{
"account_id": "acc_01HXACME",
"membership_id": "tm_01HXAMPLE",
"tier_id": "tier_01HXGOLD"
}Update thread
Rename a thread, change its priority or assign it to a teammate. Empty fields are left as they are.
Inputs
- Thread
thread_idtextRequired - The thread's id (th_...) or its reference such as T-123, from 'List threads' or an earlier step.
- Title
titletext - A new title. Leave empty to keep it.
- Priority
prioritytext - A new priority. Leave empty to keep it.One of:
0(Urgent),1(High),2(Normal),3(Low). - Assign to
assigned_to_user_idtext - The teammate to assign it to. Leave empty to keep the assignee.
Outputs
threadobject- The thread
Example output
{
"thread": {
"account": {
"id": "acc_01HXACME",
"name": "Acme Inc"
},
"assignedTo": {
"email": "sam@yourcompany.com",
"fullName": "Sam Support",
"id": "u_01HXAMPLEUSER",
"type": "user"
},
"channel": "API",
"createdAt": "2026-10-15T09:00:00.000Z",
"customer": {
"email": "jo@example.com",
"fullName": "Jo Bloggs",
"id": "c_01HXAMPLECUSTOMER",
"isEmailVerified": false
},
"description": "The export button does nothing.",
"externalId": "ticket-77",
"id": "th_01HXAMPLETHREAD",
"labels": [
{
"id": "l_01HXAMPLELABEL",
"labelType": {
"id": "lt_01HXBUG",
"name": "Bug"
}
}
],
"previewText": "The export button does nothing.",
"priority": 1,
"priorityLabel": "High",
"ref": "T-1042",
"status": "TODO",
"statusChangedAt": "2026-10-15T09:00:00.000Z",
"tier": {
"id": "tier_01HXGOLD",
"name": "Gold"
},
"title": "Cannot export invoices",
"updatedAt": "2026-10-15T09:05:00.000Z"
}
}