August 21, 2025

# Webhooks for the Parallel Task API

Get notified when Tasks complete with webhooks

Reading time: 2 min

Starting today, webhooks are available for all Task Runs on the Parallel Task API[Parallel Task API] - including Deep Research[Deep Research]. Get notified when your tasks complete instead of continuously checking their status.

## Create tasks, receive results when ready

When you're orchestrating hundreds or thousands of web research tasks, webhooks push real-time notifications to your endpoint as tasks complete - eliminating the need for constant polling. This is especially valuable for long-running or research-intensive tasks.

Common use cases include:

- **Data enrichment:** Enriching thousands of entities in your database
- **Deep research:** Running complex, research-intensive queries that can take 10-30 minutes
- **Chained workflows:** Building workflows where one task's output triggers the next
- **Batch processing:** Managing any system that creates many tasks at once

With webhooks - your orchestration code stays clean, error handling becomes straightforward, and results naturally flow into your existing queue-based architectures.

## Adding webhooks to your API calls

Setting up webhooks requires minimal changes to your existing integration. Simply include a webhook configuration alongside your task specification:

### Configure webhooks for a Task API request

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
curl --request POST \
  --url https://api.parallel.ai/v1/tasks/runs \
  --header "Content-Type: application/json" \
  --header "x-api-key: $PARALLEL_API_KEY" \
  --data '{
    "task_spec": {
      "output_schema": "Find the GDP of the specified country and year"
    },
    "input": "France (2023)",
    "processor": "core",
    "webhook": {
      "url": "https://your-domain.com/webhooks/parallel",
      "event_types": ["task_run.status"]
    }
  }'``` curl --request POST \
  --url https://api.parallel.ai/v1/tasks/runs \
  --header "Content-Type: application/json" \
  --header "x-api-key: $PARALLEL_API_KEY" \
  --data '{
    "task_spec": {
      "output_schema": "Find the GDP of the specified country and year"
    },
    "input": "France (2023)",
    "processor": "core",
    "webhook": {
      "url": "https://your-domain.com/webhooks/parallel",
      "event_types": ["task_run.status"]
    }
  }'
 
```

When your task completes, we POST the full result to your endpoint.

For security, webhooks follow standard conventions[standard conventions] including signature verification. You can manage your webhook secret keys in Settings->Webhooks[Settings->Webhooks] on our Developer Platform.

## Start using webhooks today

Webhooks are available today for all Task API processors. Get started with our documentation[documentation].

## Ready to get started?

Try Parallel[Try Parallel]Contact sales[Contact sales]

Are you an agent? Read this to onboard Parallel[Are you an agent? Read this to onboard Parallel]

By Parallel

August 21, 2025

## Related Posts91

Sep 24, 2026

# Webhooks for the Parallel Task API

## **Create tasks, receive results when ready**

## **Adding webhooks to your API calls**

## **Start using webhooks today**

## Ready to get started?

## Related Posts91

- [LangChain's Managed Deep Agents ships with built-in web search from Parallel](https://parallel.ai/blog/langchain-managed-deep-agents-parallel-search)

- [Bring trusted data into Parallel with Data Connectors](https://parallel.ai/blog/data-connectors)

- [Testing out Jev: real-world developer experience](https://parallel.ai/blog/testing-jev)

- [Introducing the Search Capability Leaderboard](https://parallel.ai/blog/search-leaderboard)

- [Merge launches Universal Context Layer with Parallel Search as its default web search provider](https://parallel.ai/blog/merge-universal-context-layer)

- [How to evaluate web search for AI](https://parallel.ai/blog/how-to-eval-web-search)

- [Building an apartment discovery tool with Parallel](https://parallel.ai/blog/apartment-finder)

- [Full Parallel API suite is now available on Google Cloud Marketplace](https://parallel.ai/blog/gcp-marketplace-full-api-suite)

- [Introducing Fast mode for Parallel Search](https://parallel.ai/blog/parallel-search-fast)

- [ Parallel ranks #1 on the Artificial Analysis Search Index, defining the Pareto frontier of quality, cost, and speed](https://parallel.ai/blog/artificial-analysis-best-search-api)

- [Always-on web monitoring research with Parallel Monitors and Hermes Agent](https://parallel.ai/blog/always-on-agents-monitor-api)

- [Building an always-on background agent to proactively support customers](https://parallel.ai/blog/customer-watch-background-agent)

- [Introducing the Parallel Responses API](https://parallel.ai/blog/responses-api)

- [Building a vendor intelligence system with Parallel](https://parallel.ai/blog/vendor-intelligence-system)

- [Parallel and Google Cloud Announce Partnership for Agentic Web Search on Gemini Enterprise Agent Platform](https://parallel.ai/blog/google-cloud-partnership)

- [$5 in free Parallel credits, every month](https://parallel.ai/blog/free-tier-parallel)

- [Introducing Turbo mode for Parallel Search](https://parallel.ai/blog/parallel-search-turbo)

- [Building a realtime voice agent with GPT-Realtime-2.1 and Parallel Search Turbo](https://parallel.ai/blog/gpt-realtime-parallel-turbo)

- [How Nooks cut web search costs 70.5% by switching to Parallel](https://parallel.ai/blog/case-study-nooks)

- [How Build created live geofenced alerts powered by Parallel for institutional real estate](https://parallel.ai/blog/case-study-build)

- [OpenClaw now has free, LLM-optimized web search by default powered by Parallel](https://parallel.ai/blog/free-web-search-openclaw)

- [Introducing real-time Entity Search](https://parallel.ai/blog/entity-search-company)

- [How we enrich & triage inbound leads using the Parallel Task API](https://parallel.ai/blog/enrich-triage-inbound-leads-parallel-task-api)

- [How AirOps creates citation-worthy content at scale, powered by Parallel](https://parallel.ai/blog/case-study-airops)

- [Introducing Index by Parallel](https://parallel.ai/blog/introducing-index-by-parallel)

- [Parallel Monitor API: New processor tiers, snapshots and event streams, and Basis on every event](https://parallel.ai/blog/monitor-api)

- [How we built parallelmpp.dev](https://parallel.ai/blog/parallel-mpp-dev)

- [How Actively's Per Account Agents use Parallel to turn the entire web into a proactive sales intelligence layer](https://parallel.ai/blog/case-study-actively)

- [Parallel Raises at $2 Billion Valuation to Scale Web Infrastructure for Agents](https://parallel.ai/blog/series-b)

- [Building a free CLI agent with Pi, Ollama, Gemma 4, and Parallel](https://parallel.ai/blog/free-CLI-agent)

- [Parallel Search is now free for agents via MCP](https://parallel.ai/blog/free-web-search-mcp)

- [Upgrades to the Parallel Search & Extract APIs](https://parallel.ai/blog/parallel-search-api)

- [How Finch is scaling plaintiff law with AI agents that research like associates](https://parallel.ai/blog/case-study-finch)

- [Genpact and Parallel Web Systems Partner to Drive Tangible Efficiency from AI Systems](https://parallel.ai/blog/genpact-parallel-partnership)

- [How Genpact helps top US insurers cut contents claims processing times in half with Parallel ](https://parallel.ai/blog/case-study-genpact)

- [A new deep research frontier on DeepSearchQA with the Task API Harness](https://parallel.ai/blog/deep-research)

- [How Modal saves tens of thousands annually by building in-house GTM pipelines with Parallel](https://parallel.ai/blog/case-study-modal)

- [How Opendoor uses Parallel as the enterprise grade web research layer powering its AI-native real estate operations](https://parallel.ai/blog/case-study-opendoor)

- [Introducing stateful web research agents with multi-turn conversations](https://parallel.ai/blog/task-api-interactions)

- [Parallel is live on Tempo, now available natively to agents with the Machine Payments Protocol](https://parallel.ai/blog/tempo-stripe-mpp)

- [How Parallel helped Kepler build AI that finance professionals can actually trust](https://parallel.ai/blog/case-study-kepler)

- [Introducing the Parallel CLI](https://parallel.ai/blog/parallel-cli)

- [How Profound helps brands win AI Search with high-quality web research and content creation powered by Parallel](https://parallel.ai/blog/case-study-profound)

- [How Harvey is expanding legal AI internationally with Parallel](https://parallel.ai/blog/case-study-harvey)

- [How Tabstack by Mozilla enables agents to navigate the web with Parallel’s best-in-class web search](https://parallel.ai/blog/case-study-tabstack)

- [Parallel Web Tools and Agents now available across Vercel AI Gateway, AI SDK, and Marketplace](https://parallel.ai/blog/vercel)

- [Authenticated page access for the Parallel Task API](https://parallel.ai/blog/authenticated-page-access)

- [Introducing structured outputs for the Monitor API](https://parallel.ai/blog/structured-outputs-monitor)

- [Introducing research models with Basis for the Parallel Chat API](https://parallel.ai/blog/research-models-chat)

- [Build a real-time fact checker with Parallel and Cerebras](https://parallel.ai/blog/cerebras-fact-checker)

- [Parallel Task API achieves state-of-the-art accuracy on DeepSearchQA](https://parallel.ai/blog/deepsearch-qa)

- [Introducing Granular Basis for the Task API](https://parallel.ai/blog/granular-basis-task-api)

- [How Amp’s coding agents build better software with Parallel Search](https://parallel.ai/blog/case-study-amp)

- [Latency improvements on the Parallel Task API ](https://parallel.ai/blog/task-api-latency)

- [Introducing Parallel Extract](https://parallel.ai/blog/introducing-parallel-extract)

- [Introducing Parallel FindAll](https://parallel.ai/blog/introducing-findall-api)

- [Introducing Parallel Monitor](https://parallel.ai/blog/monitor-api-beta)

- [Parallel raises $100M Series A to build web infrastructure for agents](https://parallel.ai/blog/series-a)

- [How Macroscope reduced code review false positives with Parallel](https://parallel.ai/blog/case-study-macroscope)

- [Introducing Parallel Search](https://parallel.ai/blog/parallel-search-api-beta)

- [Parallel processors set new price-performance standard on SealQA benchmark](https://parallel.ai/blog/benchmarks-task-api-sealqa)

- [Introducing LLMTEXT, an open source toolkit for the llms.txt standard](https://parallel.ai/blog/LLMTEXT-for-llmstxt)

- [How Starbridge powers public sector GTM with state-of-the-art web research](https://parallel.ai/blog/case-study-starbridge)

- [Building a market research platform with Parallel Deep Research](https://parallel.ai/blog/cookbook-market-research-platform-with-parallel)

- [How Lindy brings state-of-the-art web research to automation flows](https://parallel.ai/blog/case-study-lindy)

- [Introducing the Parallel Task MCP Server](https://parallel.ai/blog/parallel-task-mcp-server)

- [Introducing the Core2x Processor for improved compute control on the Task API](https://parallel.ai/blog/core2x-processor)

- [How Day AI merges private and public data for business intelligence](https://parallel.ai/blog/case-study-day-ai)

- [Full Basis framework for all Task API Processors](https://parallel.ai/blog/full-basis-framework-for-task-api)

- [Building a real-time streaming task manager with Parallel](https://parallel.ai/blog/cookbook-sse-task-manager-with-parallel)

- [How Gumloop built a new AI automation framework with web intelligence as a core node](https://parallel.ai/blog/case-study-gumloop)

- [Introducing the TypeScript SDK](https://parallel.ai/blog/typescript-sdk)

- [Building a serverless competitive intelligence platform with MCP + Task API](https://parallel.ai/blog/cookbook-competitor-research-with-reddit-mcp)

- [Introducing Parallel Deep Research reports](https://parallel.ai/blog/deep-research-reports)

## Create tasks, receive results when ready

## Adding webhooks to your API calls

## Start using webhooks today