Work order validated Webhook

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://developers.praxedo.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "public-rest-apis MCP server": {
    "url": "https://developers.praxedo.com/mcp"
  }
}
Close
POST https://webhook.example.com

Sent when a work order is validated. Validation often triggers the invoicing process in the customer ERP/CRM.

Headers

  • x-praxedo-event string Required

    The event type carried by this callback.

  • x-praxedo-secret string | null

    The custom security header defined when the subscription was created, used to verify the callback's authenticity. Null if none was set.

application/json

Body Required

Callback payload sent to your subscription's callback URL.

  • version string Required

    Payload format version. Current version is 1. Praxedo will try to maintain backward compatibility even if this version is deprecated in the future.

  • id string(uuid) Required

    Unique id of the callback, even when a retry occurs.

  • creationTime string(date-time) Required

    Time when the webhook event was received by the notification application and made ready to be sent. ISO 8601 / RFC 3339, UTC.

  • eventType string Required

    Value is workorder.validation.

  • subscriptionId string Required

    Id of the subscription that generated this callback.

  • data object Required
    Hide data attributes Show data attributes object
    • validatedAt string(date-time) Required

      Time when the work order was validated.

    • workorderCode string Required

      Work order number.

    • workorderUuid string(uuid) Required

      UUID of the work order, the same value used for the businessEvent.extension.uuid extension on getEvents and searchEvents.

    • officeCode string Required

      Code of the office configured in Praxedo.

    • actor object Required

      The entity that triggered the notification.

      Hide actor attributes Show actor attributes object
      • type string Required

        The type of entity that triggered the notification.

        Values are webUser, technician, process, or webService.

      • identifier string Required

        The unique identifier of the entity that triggered the notification. Its value depends on type (username of the web user for webUser, sync ID of the field resource for technician, or the OAuth 2.0 application name for OAuth 2.0 auth or web service username for basic auth, for webService).

Responses

  • 200

    Return a 200 status to acknowledge the callback was received. Acknowledge immediately and process the notification asynchronously to avoid a time-out (5 seconds).

POST workorder.validation
Request example 
{
  "version": "1",
  "id": "5c84b579-ae20-4e40-be1d-e8e57a96cb48",
  "creationTime": "2025-08-08T09:34:00.768098881Z",
  "eventType": "workorder.validation",
  "subscriptionId": "WEHS_251210151605_94OU25",
  "data": {
    "validatedAt": "2025-08-08T09:33:59.436326071Z",
    "workorderCode": "00091",
    "workorderUuid": "bd5917fa-3c70-490c-911f-c95aa02e6df4",
    "officeCode": "00091",
    "actor": {
      "type": "webUser",
      "identifier": "user@company.com"
    }
  }
}