Webhooks
Webhooks send real-time notifications to your firm's systems when something happens on Attorney Share, like a new case matching your filters or a referral's status changing. They make it easy to keep your CRM, intake system, or internal tools in sync with your referral activity.
What are webhooks?
A webhook is an automated message sent from Attorney Share to a URL you provide whenever a specific event happens. Your system receives the message and can use it to create or update records, alert your team, or start a workflow.
Available events
- Case Created: A new case is posted on the marketplace that matches one of your saved filters. You choose which saved filters the webhook applies to when you set it up.
- Matched Case: A case is matched with an attorney.
- Signed Case: A case agreement is signed.
- Case Status Update: A case's status changes. The payload includes the case's current status, so you can tell signed cases from unsigned ones, including cases that return to the marketplace as open leads.
How to set up a webhook
- Go to Direct Share API & Webhooks in your firm settings.
- Click Create New Webhook.
- Give your webhook a name and enter your endpoint URL. This is where we'll send notifications.
- Choose the events you want to receive.
- If you selected Case Created, choose the saved filters it applies to. You can create or edit saved filters from the Marketplace.
- Click Create webhook to save. You can edit or remove it anytime.
Frequently asked questions
Can I set up multiple webhooks?
Yes. You can create multiple webhooks, including more than one for the same event, so different teams or systems can each receive the updates they need.
What format is the data sent in?
We send a JSON payload to your endpoint URL using a POST request.
Is client information included?
No. Webhook payloads never include client PII like names or contact information. Case Created payloads include case metadata only: practice area, jurisdiction, lead quality, and case ID.
What happens if a webhook fails?
If a webhook call fails, we automatically retry up to 3 times using exponential backoff. This gives your server time to recover and still receive the notification.
For any other questions, reach out to support@attorneyshare.com.