Skip to content
Export

Webhooks

Send your Finds to your own systems automatically after every scan.

After each scan
POST https://hooks.kettle.example/pitchghost
Authorization: Bearer ••••••••

{
  "ghost": { "id": "g_41", "name": "Our customers" },
  "scan": { "id": "s_9f1", "status": "completed" },
  "finds": [
    {
      "id": "f_8c2k",
      "confidence": 88,
      "post": {
        "author": "Rohan Agarwal",
        "text": "Our help desk renewal..."
      },
      "contact": {
        "name": "Rohan Agarwal",
        "linkedin": "https://www.linkedin.com/in/..."
      }
    }
  ]
}

Set up Webhooks

  1. Turn it on for a Ghost

    In the Ghost's Notifications settings, turn on Webhook and paste your URL.

  2. Receive the Finds

    Your Ghost will start sending Finds to your webhook URL after every scan.

  3. Add an optional token

    You can optionally create a secret token to verify that the request is from PitchGhost.

What it does

  • Sends Finds to a URL you choose after every scan
  • Includes structured data about the post and the poster
  • Works with any Ghost, on any platform

A question still haunting you?

Do I need a developer?

Not necessarily. If you have a tool that can receive JSON, you can likely set it up yourself. If you want to send the data to a database or a custom tool, you may need a developer.

Can you help me set up a webhook?

We can help you get started, but we do not build custom tools for customers. However, if there is a tool you'd like us to make an official integration for, let us know!

What if our system is down?

Your Finds are still available in PitchGhost, so nothing is ever lost.

Should I use this with my AI Agent?

No. For AI tools such as ChatGPT, Claude, and Copilot, we recommend using our official MCP integration instead.

What's the difference between webhooks and the API?

Webhooks are useful for getting notified when a scan is complete. They're also read-only, so you can't change or update your Finds or Ghosts. The API is useful for reading and updating your Finds, Ghosts, and Actions from your own code.

Send Finds anywhere

Seven days free, no credit card.