---
title: "Receive Tellescope Webhook"
method: POST
path: "/webhook/tellescope"
tags: ["Webhooks - Tellescope"]
---

# Receive Tellescope Webhook

`POST /webhook/tellescope`

## Request

- Base URL: `https://api.puppeteerai.com`
- URL: `https://api.puppeteerai.com/webhook/tellescope`
- Auth: none declared. Required headers: `Authorization`

Tellescope webhook endpoint that processes webhook events.

This endpoint:
1. Receives webhook data from Tellescope (requires Authorization API key header)
2. Extracts the user ID from the webhook payload
3. Finds or creates a thread based on tellescope_user_id
4. Triggers ReceivedTellescopeWebhookTrigger with the webhook data

Expected webhook payload should contain:
- tellescope_user_id: The Tellescope user ID
- event_type (optional): The type of event
    - Example: "user_created", "medication_shipped", "appointment_scheduled", "appointment_cancelled"
    - Each event should be set on the Tellescope step body as "event_type": "event",
- Additional data fields as needed:
    - Example: appointment_date, medication_name, medication_quantity, etc.
- Example webhook payload:
    {
        "tellescope_user_id": "123456",
        "event_type": "user_created",
        "appointment_date": "2026-01-15",
        "medication_name": "Medication A",
        "medication_quantity": 100
    }

## Query parameters

- `project_id` string, required

## Headers

- `Authorization` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/getpuppeteer/apis/puppeteer-core-api.md) - [All operations](https://skmtc.dev/getpuppeteer/apis/puppeteer-core-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getpuppeteer/apis/puppeteer-core-api/revisions/94b4e928b42f?raw)