Webhooks

To receive notifications when flow sessions are completed, ProsperStack can deliver webhooks to your application.

Adding a webhook

Navigate to the webhooks configuration page by clicking Settings in the left navigation, then Manage integrations. Click Configure in the Webhooks section.

Click the Create a webhook link and enter the URL of your application endpoint that ProsperStack should deliver webhooks to.

Webhook payloads

The webhook payload contains the entire result of a flow session, including the status, survey answers and any offers presented or accepted.

Here's an example of what a payload might look like:

{
  "event": "flow_session_completed",
  "event_id": "evt_ujO4n2g2QbWtGUVg1zJSbC5I",
  "data": {
    "id": "sess_Qxu1whWCpfYlX93hH3IIojdL",
    "status": "saved",
    "created_at": "2021-07-21T16:00:54.992Z",
    "updated_at": "2021-07-21T16:01:08.006Z",
    "subscriber": {
      "id": "subr_kBiRYxBUkZmEXqDRGNM7yLTN",
      "name": "Jane Doe",
      "email": "jane@example.com",
      "status": "active",
      "created_at": "2021-05-21T16:00:54.881Z",
      "updated_at": "2021-05-21T16:00:54.881Z"
    },
    "offers_presented": [
      {
        "id": "offr_FBMw5k51DYga0K2WswbiFfMU",
        "type": "coupon",
        "name": "40% off for three months",
        "created_at": "2021-07-08T14:25:12.211Z",
        "updated_at": "2021-07-08T14:25:12.211Z"
      }
    ],
    "offer_accepted": {
      "id": "offr_FBMw5k51DYga0K2WswbiFfMU",
      "type": "coupon",
      "name": "40% off for three months",
      "created_at": "2021-07-08T14:25:12.211Z",
      "updated_at": "2021-07-08T14:25:12.211Z"
    },
    "answers": [
      {
        "question": {
          "id": "ques_e9PvoXmNB1WYYeNQOr6uRq1l",
          "type": "multiple_choice",
          "text": "What is your primary reason for leaving?"
        },
        "value": [
          {
            "id": "qopt_wrT7Rl362RVNi6eE2A4J8DLH",
            "text": "Not enough value / ROI"
          }
        ],
        "sentiment": null
      },
      {
        "question": {
          "id": "ques_acYB4paiWRGO5eFYJOAQy7XU",
          "type": "text",
          "text": "How can we improve?"
        },
        "value": "Really love the product, just can't afford it right now!",
        "sentiment": "positive"
      }
    ]
  }
}

Webhook retries

If delivering a webhook fails because your endpoint does not respond or returns an error, ProsperStack will attempt to retry the webhook for up to three days. If delivery continues to fail after three days, the webhook will be disabled and you'll receive an email to let you know that there was a problem completing the webhook delivery.

You can re-enable a disabled webhook from the webhook integrations page once any issues with the endpoint have been resolved.

Webhook limits

You can have up to ten webhooks configured with your ProsperStack account. If you need more, get in touch with us at support@prosperstack.com and we'll be happy to help.

Don't let customers slip away.