Webhooks

Handle Paperform form submissions

Receives webhook events from Paperform for form submissions (intake, feedback, surveys). Validates signature, stores payload, and queues for async processing. Configure this URL in Paperform dashboard with your webhook secret.

URL format: https://api.medley.com/webhooks/paperform?secret={your_secret}

Required hidden fields in Paperform forms:

  • sgos_participant_id: The cohort_participant.id for participant matching
  • sgos_session_id: (Optional) For session feedback forms
post/webhooks/paperform

Request

  • Base URL
    https://api.production.yourmedley.com
  • Auth
    none declared

Query parameters

secretstring

Webhook secret for authentication

Request body

eventstring
submission_idstring required

Unique Paperform submission ID

form_idstring required

Paperform form ID

created_atstring date-time

Example request

{
  "event": "form.submission.created"
}

Response

Webhook received and queued for processing

successboolean

Example response

{
  "success": true,
  "data": {
    "message": "Webhook received"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.