human_register_provider
Register a service provider's webhook endpoint to receive matched tasks. Set categories, regions, budgets, and concurrent limits for automated dispatch.
Instructions
Register a new webhook provider to receive dispatched tasks.
Any service provider (law firm, VA agency, freelancer, etc.) can register their webhook endpoint to start receiving tasks that match their profile. The system will POST task payloads to the webhook URL, signed with HMAC-SHA256 using the shared secret.
PARAMETERS:
name: Human-readable provider name (e.g. "Smith & Associates Law")
webhook_url: HTTPS URL where tasks will be POSTed
webhook_secret: Shared secret for HMAC-SHA256 webhook signatures (min 32 characters)
categories: Task categories this provider handles (errand, photo_video, data_collection, verification, delivery, digital_micro, in_person, custom)
task_types: Task types supported (physical, digital, hybrid)
regions: Regions served (e.g. ["US", "EU", "*"] where * = global)
min_budget_usd: Minimum task budget accepted (USD)
max_budget_usd: Maximum task budget accepted (USD)
max_concurrent_tasks: Max simultaneous tasks (default 10)
WEBHOOK FORMAT: Tasks are POSTed with headers:
x-dispatch-signature: sha256=
X-Dispatch-Event: task.new | task.cancel | provider.verify
X-Dispatch-TaskId:
Expected response: { "accepted": true, "external_id": "your-id" } or { "accepted": false, "reason": "..." }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Human-readable provider name (e.g. 'Smith & Associates Law') | |
| regions | Yes | Regions served (e.g. ['US', 'EU', '*'] where * = global) | |
| categories | Yes | Task categories this provider handles | |
| task_types | Yes | Task types this provider supports (physical, digital, hybrid) | |
| webhook_url | Yes | HTTPS URL where tasks will be POSTed | |
| max_budget_usd | Yes | Maximum task budget this provider accepts (USD) | |
| min_budget_usd | Yes | Minimum task budget this provider accepts (USD) | |
| webhook_secret | Yes | Shared secret for HMAC-SHA256 webhook signatures (min 32 chars) | |
| max_concurrent_tasks | No | Maximum number of tasks this provider can handle concurrently |