importThreadMessages accepts updateExisting on each message. Set it to true to update a message you already imported with the same externalId, instead of skipping it. Use it to add an emailMessageId to an email you imported without one, so replies to that email join the imported thread. The result for the message is UPDATED.Changed and removedUpdate your integration if it uses any of these fields or operations:- Importing a message again with different
attachmentIdsreturnsNOOPand keeps the stored attachments. SetupdateExistingtotrueto replace them.
For workspaces in Plain’s UK region, webhooks, customer card requests, and workflow HTTP requests come from 3 fixed IP addresses. Allowlist them alongside request signing or mTLS, not instead of them:
18.175.75.25013.43.212.14113.41.120.118
Chat
ChatAppexposesbusinessHoursSchedules.updateChatAppacceptsbusinessHoursScheduleIds. Omit the field to leave the linked schedules unchanged. Pass an empty list to unlink all of them.
- Internal notification details can be
KnowledgeGapNotificationDetailwhen a new knowledge gap is detected. It exposesknowledgeGapId.
HelpCenterexposeslinkCardsHeading,linkCards(at most 6),isLinkCardsEnabled,isPopularTopicsEnabled,popularTopicArticleIds(at most 20),heroHeading,heroSubheading,heroSearchPlaceholder, andheroAlignment(LEFTorCENTER).updateHelpCenteraccepts the same fields.isHomepageRedesignEnabledis true when the homepage redesign is on for the workspace, and false when that flag is off.HelpCenterArticleexposesisFeaturedandisPopularTopic.upsertHelpCenterArticleaccepts both.HelpCenterArticleGroupexposesdescriptionandicon.updateHelpCenterArticleGroupaccepts both.
- Added
discussion.question_resolved, sent when a user answers or dismisses a question card a connected agent asked withrequestDiscussionQuestion. Earlier versions don’t receive this event.
AccountsAccounts are the new name for tenants. Account inputs take the same tenant IDs and external IDs.
ThreadsFilter,CustomersFilter, andThreadMetricFiltersacceptaccountIdentifiers.ThreadsFilterandThreadMetricFiltersalso acceptaccountFields.CreateThreadInputandCreateThreadFromSlackMessageInputacceptaccountIdentifier.UpsertCustomerOnCreateInputacceptsaccountIdentifiers.CreateTaskInput,UpdateTaskInput, andTierMemberIdentifierInputacceptaccountId.TasksFilter,ThreadClustersFilter,ThreadLinkGroupFilter, and broadcast audience filters acceptaccountIds.- Saved view filters accept account IDs and
accountFields. Display options accepthasAccountsandhasAccountFieldExternalIds. ThreadChannelAssociationexposesaccountIdandaccountMembershipPolicy.ThreadLinkGroupexposesaccountMetrics.- Help Center access settings accept
accountIds. Portal thread visibility settings acceptcustomerAccountsandoverrideCustomerAccounts. ThreadsGroupBy,ThreadMetricGroupBy,ThreadScopePrimitiveType, andDiscussionSourceEntityTypeincludeACCOUNT.ThreadMetricGroupByalso includesACCOUNT_FIELD, which needssubKeyset to the field’s external ID.- The tenant and company fields these replace are deprecated and still work. Send one name per field in a request, not both.
tenantsacceptsfilters.sources,filters.domains, and theand,or, andnotfilters. Domain matching is exact and case-insensitive, against primary and alternate domains.tenantsacceptssortByto sort byNAME,SOURCE,TIER,OPEN_THREAD_COUNT, or a tenant field. Tenants without a value come last.- Tenant field schemas support
TENANT_REFERENCE_TYPE, which holds one or more tenant IDs. Set values withUpsertTenantFieldInput.tenantReferenceValues, and filter withtenantReferenceValuesoraccountReferenceValues.
- Added
referencesonWorkflow.references.serviceLevelAgreementPolicyIdslists the SLA policies its steps reference. workflowsacceptsfilters.references.serviceLevelAgreementPolicyIds, at most 100 IDs. Drafts are included, so combine it withisPublishedto narrow the list.WorkflowStepTypeincludesNOTE, a canvas note that holds text and never runs.WorkflowExecutionandWorkflowStepExecutionexposecredits, the credits charged for AI triage and Sidekick work in that run or step. Requiresbilling:read.
assignThreadacceptsonlyIfUnassigned. When true, a thread that already has an assignee is returned unchanged.addLabelsacceptsonlyIfNoLabels. When true, nothing is added to a thread that already has labels.labelTypesacceptsfilters.updatedAt, andsnippetsacceptsfilters.updatedAtandfilters.includeDeleted, so you can sync changes since a previous read.
BroadcastSendTargetInputacceptsincludeUnsubscribed. By default, unsubscribed channels are left out of the preview and skipped on send.broadcastSendTargetRecipientsexposesunsubscribedExcludedCountandunsubscribedRecipients, and can returnALL_RECIPIENTS_UNSUBSCRIBEDwhen every matched channel has unsubscribed.- Deliveries can have the status
SKIPPED_UNSUBSCRIBED, counted inBroadcastSendDeliveryCounts.skippedUnsubscribed. createBroadcastandupdateBroadcastacceptappendUnsubscribeLink. Null inherits the workspace setting, and true or false overrides it for that broadcast.BroadcastSendDeliveryexposesreactions, one entry per emoji on that channel’s message.
- Discussion entries can be
ThreadDiscussionQuestionEntryPayload, a Sidekick question card from an in-app session. ThreadDiscussionToolCallEntryPayloadexposesresponse, the JSON-encoded result of a successful Sidekick write.- Internal notification details can be
WebhookTargetNotificationDetail, when a webhook target is failing or was disabled, orThreadNotificationDetail, when a notification refers to a thread.
threadTimeSeriesMetricacceptsthreads_status_reopened_count, which counts threads moved from Done back to Todo.knowledgeGapsacceptsfilters.lastSeenAt.IndexedDocumentexposesknowledgeSourceId.
WorkspaceEmailDomainSettingsexposesadditionalSenderDomainsfor alternate support addresses on other domains.addWorkspaceAlternateSupportEmailAddressreturnspendingDnsRecordswhen the address needs its own DNS setup.bulkJoinSlackChannelsacceptsruleto join only the public channels that match one auto-join rule.connectedSlackChannelsacceptsfilters.excludeTestChannelsto leave out the workspace’s Slack test channel.
- Portal thread visibility settings accept
customerEmailDomainandoverrideCustomerEmailDomain, so customers see threads from everyone in their domain-based tenant.
SidekickSettingsandupdateSidekickSettingssupportpreferredIntegrations.SidekickCreditUsageDayexposesfreeCredits, the credits the day’s free beta items would have cost. Nothing was charged for them.FeatureKeyincludesHELP_CENTERSandUSER_SEATS.BillingSubscriptionexposesnextPlan, the plan one tier above the current one.
FeatureKeyno longer includesDATA_IMPORTERS. Check the per-importer keys, such asZENDESK_IMPORTER, instead.
- Added
account.account_created,account.account_updated,account.account_deleted,account.account_membership_changed,account.account_field_created,account.account_field_updated, andaccount.account_field_deleted. Accounts are the new name for tenants. Earlier versions don’t receive these events.
SLA policies
- Added
serviceLevelAgreementPoliciesandserviceLevelAgreementPolicyto list the SLA policies in a workspace or fetch one by ID. Both need theserviceLevelAgreement:readpermission. - Added
createServiceLevelAgreementPolicy,updateServiceLevelAgreementPolicy, anddeleteServiceLevelAgreementPolicy. A policy holds at most one target perServiceLevelAgreementType, and each target setsminutes,warnBefore, and optionalbusinessHoursScheduleIds. - Added
updateThreadServiceLevelAgreementPolicyto apply a policy to a thread. PassserviceLevelAgreementPolicyId: nullto remove it. Needs thethread:editpermission. ThreadexposesserviceLevelAgreementPolicy.ThreadsFilterand saved view filters acceptserviceLevelAgreementPolicyIds.
- Added
FirstResolutionTimeServiceLevelAgreementandTotalResolutionTimeServiceLevelAgreement. First resolution time is met when the thread is first marked Done. Total resolution time keeps counting after the thread is reopened. createServiceLevelAgreementaccepts exactly one offirstResponseTimeMinutes,nextResponseTimeMinutes,firstResolutionTimeMinutes, ortotalResolutionTimeMinutes.pauseOnStatusDetailTypessets which thread status details pause a resolution-time clock. It defaults to waiting for the customer. Pass an empty list to keep the clock running.updateServiceLevelAgreementaccepts the matching minute inputs andpauseOnStatusDetailTypes.ServiceLevelAgreementTypeincludesFIRST_RESOLUTION_TIMEandTOTAL_RESOLUTION_TIME.ServiceLevelAgreementStatusSummaryexposesfirstResolutionTimeandtotalResolutionTime.ServiceLevelAgreementStatusDetailPendingandServiceLevelAgreementStatusDetailImminentBreachexposepausedAtandremainingMinutesAtPausewhen a resolution-time clock is paused.
createThreadFromSlackMessageacceptstitle,description,labelTypeIds,tenantIdentifier,priority,externalId, andthreadFields. They apply only when a new thread is created. An already-ingested message ignores them.changeThreadPriorityacceptsonlyIfDefault. When true, the mutation changes priority only if it is still Normal and has not been set since thread creation. Otherwise it returns the unchanged thread.
- WAIT steps accept
businessHoursScheduleIds. When set,durationcounts only while one of the selected schedules is open.
createWebhookTargetandupdateWebhookTargetacceptheaders.WebhookTarget.headersreturns the configured names. Values are never returned.
broadcastsand related connections exposetotalCount.
sidekickCreditUsageByDayandsessionCountinclude work done by the workspace’s agents, not only Sidekick sessions. Requiresbilling:read.BillingTopupCreditBalanceexposeslifetimeGrantedandlifetimeUsedfor top-up credits.
- Added
isPlainManagedDomainonWorkspaceEmailDomainSettings, so you can tell whether Plain manages the domain. - Added
isFromPlainManagedDomainonThread, which is true when any of the thread’s support email addresses is on a Plain-managed domain.
- Added
policyandbusinessHoursSchedulestoserviceLevelAgreementonthread.service_level_agreement_status_transitioned.tierisnullfor SLAs that belong to a policy, anduseBusinessHoursOnlyis deprecated. Earlier versions receive policy SLAs as{ "type": "UNKNOWN" }, andunversionedtargets don’t receive their events.
- Added
FIRST_RESOLUTION_TIMEandTOTAL_RESOLUTION_TIMEtoserviceLevelAgreement.typeonthread.service_level_agreement_status_transitioned, withfirstResolutionTimeMinutesandtotalResolutionTimeMinutes. Earlier versions receive these SLAs as{ "type": "UNKNOWN" }, andunversionedtargets don’t receive their events.
Business hours schedules
- Added
businessHoursScheduleandbusinessHoursSchedules, which read the named schedules in your workspace. Both need thebusinessHours:readpermission. - Added
createBusinessHoursSchedule,updateBusinessHoursSchedule, anddeleteBusinessHoursSchedule. Overlapping and adjacent slots are merged when you write them. - SLA types expose
businessHoursSchedules, so you can read which schedules an SLA is tracked against. An empty list means it is tracked 24/7. businessHoursScheduleIdsonServiceLevelAgreementInputandUpdateServiceLevelAgreementInputnow takes IDs you can create, so you can point an SLA at a specific schedule.
- Added
lastTriggeredAtonWorkflow, andLAST_TRIGGERED_ATonWorkflowsSortField. Workflow.orderis the 1-based dispatch priority among published event workflows with a start step.moveWorkflowupdates it.
- Added
imageUrlonBroadcastReactionCount, so you can render a custom emoji.
DiscussionsFilter.isWorkflowTaskseparates the Sidekick tasks generated fromask_sidekickworkflow steps from the discussions that people join. Passfalsefor a human-facing list.
- Replace
businessHoursSlotswithbusinessHoursSchedules. - Replace
syncBusinessHoursSlotswithcreateBusinessHoursScheduleorupdateBusinessHoursSchedule. It errors when the workspace has more than one schedule. - Replace
useBusinessHoursOnlywithbusinessHoursScheduleswhen you read an SLA, and withbusinessHoursScheduleIdswhen you write one.
Slack
- Added
createThreadFromSlackMessage, so you can create a thread from a top-level message in a connected customer Slack channel. It is the trigger for API-only ingestion, and it works in every other ingestion mode too. - Added
API_ONLYtoSlackIngestionMode.
- Added
aiFeedback, so you can list the feedback your team has left on Ari replies and other Plain AI features. Filter byfeatures,sentiments, andcreatedAt. RequiresaiFeatureFeedback:read.
MachineUser.isAssignableToThreadsreports whether connected agent pricing allows assigning that machine user to a thread.
Broadcasts
- Added
broadcastAudience,broadcastAudiences,createBroadcastAudience,updateBroadcastAudience, anddeleteBroadcastAudience, so you can save and reuse broadcast audiences. - Added
broadcastSendTargetRecipients, so you can see who a send target’sscope,filters,recipients, andexcludeRecipientsresolve to before you save or send. - Added
sendTestBroadcast, so you can post a draft to up to 10 named Slack channels without changing the broadcast’s status.
Reply as a user
replyToThreadacceptsimpersonation.asUser, so an API key can reply as a team member.impersonationtakes exactly one ofasCustomerorasUser.createApiKeyandupdateApiKeyacceptimpersonationAllowList, andApiKey.impersonationAllowListreturns it. It names the users, roles and custom roles a key may reply as.TimelineEntry.createdByreturns whose credentials wrote an entry, which is the machine user for a reply sent as a team member, whileactorstays the team member. It is null on entries created before this was recorded.
Workspace.isSSOEnabledandWorkspace.isDirectoryEnabledreport an active SSO connection and a configured directory, andUser.isManagedByDirectorymarks the users the directory manages.WorkflowsFilter.createdByUserIdsfilters workflows by creator, andsortByacceptsNAME,CREATED_ATandPUBLISHED_AT.
- Added
discussion.turn_stop_requested, sent when someone requests that an agent stop its current turn. The payload containsdiscussion,requestedBy, andrequestedAt.
Broadcasts
- Broadcasts expose sends, deliveries, reactions, reply threads,
SLACK_BLOCK_KITcontent, and link unfurling. scheduleBroadcast.scheduledAtis optional, so you can return a scheduled broadcast to draft.
Task.sourceLinkslists linked knowledge gaps.knowledgeGapsacceptsfilters, including status.moveWorkflowplaces a workflow after another, or first whenafterWorkflowIdis null. Read where it sits from lexicographicposition, and sortworkflowswithsortBy.EmailEntry.inlineAttachmentsandImportThreadMessageInput.emailMessageIdare available.Thread.broadcastandThreadsFilter.broadcastIdsrelate reply threads to a broadcast.changeThreadDiscussionStatusresolves and reopens a discussion.
- Replace
BroadcastSendTarget.channelsandBroadcastSendTargetInput.channelswithscope,filters,recipients, andexcludeRecipients. - Replace
ThreadDiscussionAgentStatus.NEEDS_INPUTwithTOOL_CALL_APPROVAL_PENDING. - Replace
isSuccessonThreadDiscussionToolCallEntryPayloadwithstatus(DiscussionToolCallStatus).serviceandopare optional. - Remove
DiscussionsFilter.hasAgentSession. Filter withagentTypesandagentMachineUserIds. - Replace
orderon workflow inputs withmoveWorkflow. Settingorderno longer affects ordering, andWorkflow.orderis deprecated in favor ofposition. - Replace
markThreadDiscussionAsResolvedwithchangeThreadDiscussionStatus, which moves a discussion betweenOPENandRESOLVED.
- Added
task.task_created,task.task_updated,task.task_status_transitioned, andtask.task_deleted. A status change fires bothtask.task_updatedandtask.task_status_transitioned. - A task raised by Plain’s AI agent for a knowledge gap has a
sourceLinksentry withsourceType: "knowledge_gap".
- Added
discussion.tool_call_approval_requestedanddiscussion.tool_call_approval_resolvedfor agent tool-call approval changes. - Added
agentStatusto discussions indiscussion.message_created.
GraphQL schema
- Added
createBroadcast,updateBroadcast,deleteBroadcast, andscheduleBroadcastmutations, plusbroadcast,broadcasts, andsearchBroadcastsqueries, so you can manage broadcasts programmatically.
- The Broadcasts guide now documents using the API, including the permissions your API key needs to create, update, and send broadcasts.
Added
workspaceFiles to messages in discussion.message_created.Webhook versions · JSON schemaAdded
discussion.discussion_created, sent when a discussion is started on a thread. Existing event payloads did not change.Webhook versions · JSON schemaAdded
thread.thread_locked, sent when a thread is locked. Existing event payloads did not change.Webhook versions · JSON schemaDiscussion
status is now OPEN or RESOLVED. Agent activity moved to agentStatus (UNKNOWN, IDLE, and related values). If you filter or switch on the old discussion status values (IDLE, IN_PROGRESS, APPROVAL_REQUESTED), update those clients.Added the discussion.message_created webhook event, sent when a message is posted in a discussion. Existing event payloads did not change.Discussions · Webhook versions · JSON schemaAdded
isCustomAgent on MachineUser. true when the machine user is a connected agent the workspace built, rather than an ordinary API integration.Machine users- Added
thread.note_mention_createdwhen a note mentions a machine user (for example an agent). Payload includesthread,note, andmentions(an array ofmachineUser). - Added
attioandemail_domaintotenant.sourceonthread.tenant_updated.
Added
createTenant. It fails if a tenant already exists with the given externalId. Use upsertTenant when you want create-or-update. Requires tenant:create.Added
attio and email_domain to tenant.source on thread.tenant_updated.Webhook versions · JSON schema- Added
threadsByExternalIdto list every thread with a givenexternalId, across customers.threadByExternalIdstill returns a single thread for one customer. - Added
knowledgeSourceCitationsByThreadfor the knowledge sources cited by AI replies on a thread.
Added
updateThreadExternalId. Pass externalId: null to clear it. Requires thread:edit.Updating threads- Added
WAITING_INDEFINITELYtostatusDetail.typeonthread(snoozed with no duration). The same value is available on the thread type in the API. componentUser.usermay be amachineUseras well as auserwhen a UI component references a machine user.
Added
importThread and importThreadMessages for backfilling historical threads without firing SLAs or autoresponders. Each externalId is idempotent (NOOP on replay). Requires thread:import.Importing threadsAdded
dateTime and user UI component types to custom timeline entries.Webhook versions · JSON schemaAdded a paginated
discussions query with filters for user and discussion type.Fetch discussions- Added
thread.thread_tenant_updated, sent when a thread’s tenant changes. - Added
reactionChangeonthread.slack_message_updated.
Added
webhookDeliveryAttempts so you can inspect delivery attempts, including response status and body, without leaving the API.Delivery attemptsAdded
createDiscussion, sendDiscussionMessage, and the single discussion query, so you can open a side-conversation on a thread and post into it programmatically.Create a discussion · Send a messageAdded
importCustomers, importTenants, and importTenantFieldSchemas for bulk backfills from another system. Each is idempotent on externalId and returns added, updated, and skipped counts.Added the
workflowButton UI component type to custom timeline entries.Webhook versions · JSON schemaAdded
changeType on thread.slack_message_updated.Webhook versions · JSON schema- Added
dateValueonthreadField. - Added
DATEandCURRENCYtothreadField.type.
Added
updateNote for editing an existing note on a thread.Added numberValue on threadField and NUMBER to threadField.type.Notes · Webhook versions · JSON schemaAdded
updateThreadAgentStatus to set a thread’s AI agent status to IN_PROGRESS, HANDED_OFF, or HANDLED.Building agentsTasks are now available over the API:
createTask, updateTask, deleteTask, plus task, taskByRef, and a filterable tasks query.TasksAdded
labelTypeByExternalId, so you can look up a label type by the ID it has in your own system.Label typesAdded
deleteThread for permanently deleting a thread.Deleting threadsAdded
searchKnowledgeSources to search the knowledge your agents draw on.Searching knowledgeAdded
upsertTenantField, deleteTenantField, and deleteTenantFieldSchema, completing tenant field management over the API.Account fieldsAdded the
tenantFieldSchemas query and upsertTenantFieldSchema mutation, including field visibility.Account fieldsAdded
deleteTenant. Deleting a tenant unlinks it from all customers and removes its fields.Deleting accountsAdded the
knowledgeSources query and deleteKnowledgeSource mutation.Searching knowledge- Added
additionalAssigneesonthread. - Added
externalIdandisExcludedFromAionlabelType.

