> ## Documentation Index
> Fetch the complete documentation index at: https://plain-docs-orca-916-agent-docs-restructure.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a thread event

> Add a custom event to a single thread's timeline.

Thread events let you record something that happened in your own product against one specific thread, so it appears in that thread's timeline only.

<Snippet file="graphql/sdk-note.mdx" />

<Info>
  A thread event will only be created in the thread ID provided. If you want an event to appear in
  all threads for a customer please use a [customer
  event](/graphql/events/create-customer-event).
</Info>

To create a thread event you need a thread ID.

You can get this by [creating a thread](/graphql/threads/create) in Plain, from data in webhooks or other API calls you made. If you want to test this, press <kbd>⌘</kbd> + <kbd>K</kbd> on any thread and then "Copy thread ID" to get an ID you can experiment with.

In this example we'll be creating the following event:

<Frame>
  <img src="https://mintcdn.com/plain-docs-orca-916-agent-docs-restructure/wMjMwWh_ieDOjCce/public/images/events-api-key-example.png?fit=max&auto=format&n=wMjMwWh_ieDOjCce&q=85&s=4a58477d5db2e692246e3ac897bffd9c" alt="Example event" width="1972" height="634" data-path="public/images/events-api-key-example.png" />
</Frame>

For this you'll need an API key with the following permissions:

* `threadEvent:create`
* `threadEvent:read`

<Snippet file="graphql/create-thread-event.mdx" />