You can configure webhook endpoints via the Webhooks API to be notified about events that happen in the Business Lifecycle.

PropertyDescription
objectstringA definition of the type of object returned.
idstringThe ID of the webhook endpoint.
urlstringThe URL of the endpoint.
secretstringThe secret used to generate webhook signatures. This secret is ONLY used to generate a signature, and is never exposed in a response.
enabled_eventsstring[]The events the webhook is enabled for.
created_attimestampTimestamp representing when the webhook endpoint was created.
updated_attimestampTimestamp representing when the webhook endpoint was last updated.
disabled_attimestampTimestamp representing when the webhook was disabled. Null if the webhook is currently enabled.
oauth_client_idstringThe ID of the OAuth client the webhook is being created on behalf of.
{
  "object": "webhook",
  "id": "2c64e4d5-eb25-4e17-81e6-506b12b774a2",
  "url": "https://example.com/middesk/endpoint"
}

Webhook Events

business.createdSent when a business submitted to the Create a Business endpoint has been created successfully. Contains only submitted business information and Middesk results are not returned in this webhook.
business.updatedSent when Middesk has finished processing a business and the results are ready to be evaluated.
tin.retriedIf a tin verification fails because the IRS is unavailable, Middesk will periodically retry the verification. Once the verification has been process successfully the IRS, Middesk will provide a tin.retried webhook with the results.
business.approvedAfter Middesk has finished processing a business (ie status: in_review), customer's may optionally make a call to our Update a Business endpoint to update the status to "approved." When that takes place this webhook will be sent.
business.rejectedAfter Middesk has finished processing a business (ie status: in_review), customer's may optionally make a call to our Update a Business endpoint to update the status to "rejected." When that takes place this webhook will be sent.
address.createdSent when an address has been added to a registration attached to a business enrolled in Middesk's SOS Filings Monitoring product.
address.deletedSent when an address has been removed from a registration attached to a business enrolled in Middesk's SOS Filings Monitoring Subscription.
name.createdSent when a business or DBA name has been added to a registration attached to a business enrolled in Middesk's SOS Filings Monitoring Subscription.
name.deletedSent when a business or DBA name has been removed from a registration attached to a business enrolled in Middesk's SOS Filings Monitoring Subscription.
person.createdSent when an individuals name has been added to a registration attached to a business enrolled in Middesk's SOS Filings Monitoring Subscription.
person.deletedSent when an individuals name has been removed from a registration attached to a business enrolled in Middesk's SOS Filings Monitoring Subscription.
registration.createdSent when a new registration has been attached to a business enrolled in Middesk's SOS Filings Monitoring Subscription.
registration.deletedSent when a registration has been detached from a business enrolled in Middesk's SOS Filings Monitoring Subscription.
subscription.createdSent when a business has been enrolled in a new subscription.
subscription.updatedSent when a business subscription has been updated.
watchlist_result.createdSent when a new watchlist hit has been found for a business that has been enrolled in Middesk's Watchlist Monitoring Subscription.
tin.retrievedSent when a tin result has been found via Middesk's Tin Discovery
bankruptcy.createdSent when a new bankruptcy has been found for a business enrolled in Middesk's Bankruptcy Monitoring Subscription.
lien.updatedSent when the status of a Lien changes to filed when Middesk files with the state, or to open when Middesk has reflected the Lien.