How webhooks work

No code needed. Copy a URL, paste it in your platform. Cratio auto-detects incoming fields.

1. 1Create a webhook in Integrations → Webhooks. Give it a name and source label.
2. 2Copy the unique Webhook URL (e.g., https://api.cratio.com/webhook/fb-abc123).
3. 3Paste the URL into your platform (Facebook, IndiaMART, your web form, etc.).
4. 4Cratio receives the POST, maps fields, and creates a lead automatically.
5. 5The URL is the shared secret — do not publish it publicly.

Your webhook URL

Each webhook you create gets a unique URL. This URL is the shared secret — it authenticates the integration without any Authorization header. Go to Integrations → Webhooks in your Cratio account to create and copy your URL.

https://api.cratio.com/webhook/fb-abc123

The path segment after /webhook/ is unique to your account and webhook configuration. Do not publish it publicly.

Incoming payload

Send a POST request with a JSON body to your Webhook URL. No Authorization header needed. Cratio auto-detects fields from the first request.

curl -X POST "https://api.cratio.com/webhook/fb-abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Rahul Sharma",
    "email": "rahul@techcorp.in",
    "phone": "+91 98765 43210",
    "company": "TechCorp Solutions",
    "city": "Mumbai",
    "source": "Facebook Ads",
    "message": "Interested in your product"
  }'

Response:

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "created"
  }
}

Field mapping

Cratio auto-detects common field names from the first request. Use the field mapping wizard in Integrations → Webhooks to connect any custom fields.

Default lead settings

Set defaults for all leads from this webhook — applied when the payload does not include that field.

• Default AssignmentAssign incoming leads to a specific user. Lead distribution rules in Settings override this.
• Default StatusInitial status for all leads (default: New).
• Default SourceSource label if not in the payload (e.g., Facebook Ads).
• Default TagsTags applied to every lead from this webhook.

Platform guides

Step-by-step instructions for connecting Cratio webhooks to the most common lead sources.

Security notes

• ·The webhook URL is the shared secret. Anyone with the URL can push leads to your account.
• ·Do not publish the URL in public repositories, forums, or documentation.
• ·If you suspect the URL has been compromised, regenerate it immediately from Integrations → Webhooks → Settings.
• ·You can disable a webhook at any time from the same settings page. Disabled webhooks return 403 to callers.
• ·Cratio does not verify request signatures on inbound webhooks. The URL token provides the security boundary.