Discussion created

Fired when a discussion is started on a thread.

This event is fired when a discussion is started, on a thread or on its own.

Read discussion.type before acting. AGENT_SESSION is a Sidekick conversation, which is the only type a custom agent answers; SLACK and EMAIL discussions are conversations with people. Read discussion.agent to see which machine user the conversation was opened against. It is null on a discussion Plain’s own Sidekick runs.

Schema

View JSON Schema →

Example:

{
  "timestamp": "2026-09-07T10:12:04.881Z",
  "workspaceId": "w_01HZ7QK3M9N4P5R6S7T8V9W0XY",
  "payload": {
    "eventType": "discussion.discussion_created",
    "discussion": {
      "id": "thd_01HZ8A1B2C3D4E5F6G7H8J9K0M",
      "type": "AGENT_SESSION",
      "agent": {
        "id": "mu_01HZ8B3C4D5E6F7G8H9J0K1M2N",
        "fullName": "Acme Support Agent",
        "publicName": "Acme Support",
        "description": "Answers billing questions in Sidekick",
        "createdAt": "2026-09-01T09:14:22.117Z",
        "createdBy": {
          "actorType": "user",
          "userId": "u_01HZ8C4D5E6F7G8H9J0K1M2N3P"
        },
        "updatedAt": "2026-09-01T09:14:22.117Z",
        "updatedBy": {
          "actorType": "user",
          "userId": "u_01HZ8C4D5E6F7G8H9J0K1M2N3P"
        },
        "deletedAt": null,
        "deletedBy": null
      },
      "status": "OPEN",
      "agentStatus": "IDLE",
      "threadId": "th_01HZ8N2P3Q4R5S6T7V8W9X0Y1Z"
    }
  },
  "id": "pEv_01HZ8F7G8H9J0K1M2N3P4Q5R6S",
  "webhookMetadata": {
    "webhookTargetId": "whTarget_01HZ8K1M2N3P4Q5R6S7T8V9W0X",
    "webhookTargetVersion": "2026-09-06",
    "webhookDeliveryAttemptId": "whAttempt_01HZ8M2N3P4Q5R6S7T8V9W0X1Y",
    "webhookDeliveryAttemptNumber": 1,
    "webhookDeliveryAttemptTimestamp": "2026-09-07T10:12:04.881Z"
  },
  "type": "discussion.discussion_created"
}

Using the Webhooks SDK

You can use the @team-plain/webhooks package to parse and verify this event with full type safety:

import { verifyPlainWebhook } from "@team-plain/webhooks";

const result = verifyPlainWebhook(rawBody, signature, secret);

if (result.error) {
  console.error(result.error.message);
} else {
  // result.data is fully typed with the event payload
  const event = result.data;
  console.log(event.eventType, event.payload);
}