Webhooks

Webhooks let you receive real-time updates when certain actions happen in your Samply account—like when an upload finishes or a comment is added. They’re especially useful if you’re integrating Samply into your own tools, dashboards, or automation systems.

How it works

When one of your selected events occurs, Samply sends an HTTP POST request to the webhook URL you provide. The request contains a JSON payload with details about the event.

You can set up multiple webhooks, each targeting different events or destinations.

Creating a Webhook

1. Label – A name to help you identify the webhook.
2. URL – The endpoint where Samply will send the event data.
3. Events – Select one or more events you’d like to receive notifications for:

Available Events

Event	Description
Player created	A new player is created
Player updated	An existing player is modified
Project created	A new project is created
Project updated	An existing project is modified
Comment created	A new comment is posted
Upload started	A file begins uploading
Upload completed	A file has finished uploading
Upload failed	A file upload fails due to an error

Once saved, Samply will notify your URL any time one of your selected events occurs.

Security

• Webhook data is sent over HTTPS only.
• Be sure to store your endpoint securely and validate incoming data before acting on it.

Example Payload

{
  "id": "a459f855-da9f-4dfc-9181-35da2badfdcc",
  "type": "comment.created",
  "object": "event",
  "projectid": "mSg4Nu5vAch9pkCEcgDP",
  "boxid": "cd01f0c1-f1b3-4bc9-95c3-e14e5b01fbe1",
  "boxName": "Mystery Machine",
  "commentid": "uDXE192QibaDfK51eTTN",
  "data": {
    "after": {
      "id": "uDXE192QibaDfK51eTTN",
      "object": "comment",
      "message": "<p>Scooby Doo Where Are You?</p>",
      "creator": {
        "displayName": "eschirtz",
        "email": null,
        "photoURL": null,
        "uid": "TlYYwlHzZohpleC8a2Vo1SYY1902"
      },
      "isReply": false,
      "timeCreated": 1750041281427,
      "timeModified": 1750041281427
    }
  },
  "timeCreated": 1750041281427,
  "uid": "zklUx8RcjHZTqqi4mWoQNoBMsU03"
}

Tips

• Test your endpoint with a tool like Webhook.site before going live.
• Use webhooks alongside tools like Zapier or Make to trigger automations.
• You can delete or update webhooks at any time from your Samply preferences.

Need help? Contact support or check out our integration guides.