How to Check the Status of a Running Postman Flow Triggered via GitHub Actions?

Ask the Experts and Postman Tips
, , ,
1

I have set up Postman flows over the Postman cloud and created a pipeline to trigger these flows via GitHub Actions. While the initial trigger works fine and the webhook returns a response, I am unable to track the status of the flow to determine if it has completed successfully.

Here is the response I get in the console when the flow is triggered:

{
    "event": "<event_id>",
    "timestamp": 1736961216065,
    "state": "processing",
    "message": "A flow run has started for this webhook call"
}

The response indicates the flow has started, but I need to track whether the flow has completed. Unfortunately, the webhook does not return any further updates about the status.

I have tried polling the following endpoints via GitHub Actions to check the flow’s status, but they always return the same response as above, indicating only that the flow has started:

  1. https://<webhook_id>.flow.pstmn.io/status?event=<event_id>
  2. https://<webhook_id>.flow.pstmn.io/status

Both endpoints return the same response:

{
    "event": "<event_id>",
    "timestamp": 1736961216065,
    "state": "processing",
    "message": "A flow run has started for this webhook call"
}

I am unsure how to proceed further to check whether the flow has completed or failed.

Platform Details:

  • Postman App Version: Postman Cloud Flows
  • Operating System: [Specify OS and version]
  • Environment: GitHub Actions

Could you please help me understand how to check the status of the Postman flow to determine if it has completed successfully?

2

Hi @maintenance-candida4

Welcome to the forums!

Currently, Flows doesn’t support synchronous behavior when calling the webhook URL—the response code you receive simply indicates that the flow has been triggered, not completed. Additionally, we don’t have a polling endpoint available to check for flow completion at this time. However, we’re currently working to accommodate use cases like yours.

Could you share a little bit more about what you are using your flows for as part of your pipeline?

3

Thanks @flows-daniel for the response. Currently we are using flows to test our backend in modules. And then we are having a Github Action that run those flows to make ensure that every test is running with no errors before making a push to the stage/main branch. But currently we cannot restrict the pipeline as there are no response back from the postman flows.

4

Thank you for the explanation. I will update here once we release some new features that will allow you to solve this problem.

1 Like