API Reference

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.

agent_jurisdiction_registration.created

If subscribed, this event will be sent whenever a jurisdiction registration is created.

agent_jurisdiction_registration.updated

If subscribed, this event will be sent whenever the status of a jurisdiction registration is updated.

Example Payloads:

{
  "id": "middesk-event-id",
  "account_id": "your-middesk-account-id",
  "namespace": "agent_jurisdiction_registration.created",
  "data": {
    "object": {
      "id": "middesk-jurisdiction-registration-id",
      "company_id": "middesk-child-company-id",
      "external_id": "middesk-external-id",
      "status": "government_processing",
      "tax_type": "CITY",
      "jurisdiction_name": "Wunschshire",
      "jurisdiction_slug": "wunschshire",
      "created_at": "2025-07-29T22:11:48Z",
      "updated_at": "2025-07-29T22:11:48Z",
      "submitted_at": null,
      "completed_at": null,
      "status_updated_at": "2025-07-29T22:11:48Z",
      "blocked_by": null,
      "blocked_until": null,
      "transfer": false,
      "items": [],
      "registration_request_id": null,
      "object": "jurisdiction_registration"
    }
  },
  "created_at": "2025-07-30T19:06:07Z"
}

{
  "id": "middesk-event-id",
  "account_id": "your-middesk-account-id",
  "namespace": "agent_jurisdiction_registration.updated",
  "data": {
    "object": {
      "id": "middesk-jurisdiction-registration-id",
      "company_id": "middesk-child-company-id",
      "external_id": "middesk-external-id",
      "status": "government_processing",
      "tax_type": "CITY",
      "jurisdiction_name": "Wunschshire",
      "jurisdiction_slug": "wunschshire",
      "created_at": "2025-07-29T22:11:48Z",
      "updated_at": "2025-07-29T22:11:48Z",
      "submitted_at": null,
      "completed_at": null,
      "status_updated_at": "2025-07-29T22:11:48Z",
      "blocked_by": null,
      "blocked_until": null,
      "transfer": false,
      "items": [],
      "registration_request_id": null,
      "object": "jurisdiction_registration"
    }
  },
  "created_at": "2025-07-30T19:06:54Z"
}

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 Tax Registration Items are available
duplicateJurisdiction registration and corresponding Tax Registration Items were marked as duplicate as the company's information was already registered with the state/local government
unmanagedJurisdiction registration is not currently supported by Middesk
not_requiredJurisdiction registration is deemed by the government as not required for this business in this jurisdiction