Below are webhooks that can be configured to notify your systems upon any changes to the jurisdiction registration. Currently we support when a registration is created or when it's updated.
Webhooks let your application receive real-time updates about Jurisdiction Registration Requests created via the Create Registration Request endpoint.
How it works
- You register an HTTPS endpoint that accepts POST requests.
- We send you events as JSON whenever something changes.
- You return 200 OK to acknowledge receipt.
Subscribe to events
You can subscribe to the following event types:
agent_jurisdiction_registration.created
Sent when a Jurisdiction Registration is created by Middesk.agent_jurisdiction_registration.updated
Sent whenever the status of a Jurisdiction Registration is updated by Middesk
Example Payloads:
{
"id" => "5dcf54c3-7b81-43ad-94ac-70394fed291b",
"company_id" => "dbb0f373-b744-465e-941e-ab76d4194a86",
"external_id" => nil,
"status" => "middesk_processing",
"tax_type" => "FLI",
"jurisdiction_name" => "Connecticut Paid Leave",
"jurisdiction_slug" => "connecticut_paid_leave",
"created_at" => "2025-08-13T18:21:36Z",
"updated_at" => "2025-08-13T18:21:36Z",
"submitted_at" => nil,
"completed_at" => nil,
"status_updated_at" => "2025-08-13T18:21:36Z",
"blocked_by" => nil,
"blocked_until" => nil,
"transfer" => false,
"items" => [{
"agency" => "Connecticut Paid Family Leave Authority",
"label" => "CT PFML Account Number",
"key" => "ct_fli_account_number",
"value" => nil,
"state" => "CT",
"status" => "open",
"updated_at" => "2025-08-13T18:21:36Z"
}],
"registration_request_id" => "e5085880-fd34-4a8d-a91c-30b6d44ac6e5",
"object" => "jurisdiction_registration"
}
{
"id" => "5dcf54c3-7b81-43ad-94ac-70394fed291b",
"company_id" => "dbb0f373-b744-465e-941e-ab76d4194a86",
"external_id" => nil,
"status" => "completed",
"tax_type" => "FLI",
"jurisdiction_name" => "Connecticut Paid Leave",
"jurisdiction_slug" => "connecticut_paid_leave",
"created_at" => "2025-08-13T18:21:36Z",
"updated_at" => "2025-08-13T19:21:36Z",
"submitted_at" => nil,
"completed_at" => nil,
"status_updated_at" => "2025-08-13T18:21:36Z",
"blocked_by" => nil,
"blocked_until" => nil,
"transfer" => false,
"items" => [{
"agency" => "Connecticut Paid Family Leave Authority",
"label" => "CT PFML Account Number",
"key" => "ct_fli_account_number",
"value" => "456-123-7890",
"state" => "CT",
"status" => "open",
"updated_at" => "2025-08-13T19:21:36Z"
}],
"registration_request_id" => "e5085880-fd34-4a8d-a91c-30b6d44ac6e5",
"object" => "jurisdiction_registration"
}
Jurisdiction Registration 'status'
Status | |
---|---|
information_requested | Jurisdiction registration requires additional information from the customer before processing can continue |
blocked_by_government | Jurisdiction registration is blocked by government requirements (e.g., waiting for hire date, payroll date, or liability date) |
middesk_processing | Jurisdiction registration is being processed by Middesk staff |
government_processing | Jurisdiction registration has been submitted to the government and is being processed by the government |
completed | Jurisdiction registration has been completed and deliverables (e.g. Account Number, UI Account number, UI Tax rates are available) |
duplicate | Jurisdiction registration and corresponding deliverables were marked as duplicate since the company's information was already registered with the state/local government |
unmanaged | Jurisdiction registration not managed by Middesk |
not_required | Jurisdiction registration is deemed by the government as not required for this business in this jurisdiction |