Jurisdiction Registrations

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

  1. You register an HTTPS endpoint that accepts POST requests.
  2. We send you events as JSON whenever something changes.
  3. 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_requestedJurisdiction registration requires additional information from the customer before processing can continue
blocked_by_governmentJurisdiction registration is blocked by government requirements (e.g., waiting for hire date, payroll date, or liability date)
middesk_processingJurisdiction registration is being processed by Middesk staff
government_processingJurisdiction registration has been submitted to the government and is being processed by the government
completedJurisdiction registration has been completed and deliverables (e.g. Account Number, UI Account number, UI Tax rates are available)
duplicateJurisdiction registration and corresponding deliverables were marked as duplicate since the company's information was already registered with the state/local government
unmanagedJurisdiction registration not managed by Middesk
not_requiredJurisdiction registration is deemed by the government as not required for this business in this jurisdiction