Help Center

How to Utilize TicketSocket Webhooks

  • Updated

Setting up TS Webhooks
image (1).png
 

Webhooks are based on Triggers which are fired in our ticketing platform when specific events occur. To get started navigate to Settings > Site > Webhooks. Create a new configuration and name it. You may then select from the following triggers via the "Type" field:

  • Attendee Checkin Complete
  • Begin Checkout
  • Bulk Ticket Change Complete
  • Information Change Complete
  • Order Complete
  • Order Information Change Complete
  • Order Event Change Complete
  • Send to a Friend Complete

Enabled: Choose if your webhook configuration is live or not.

Enable Logging: allow for success and error logging of the webhooks

Target URL: add the specific URL you're using to receive webhooks

Salt for Hash: a salt is a random string added to the data before hashing to enhance security, especially for HMAC (Hash-based Message Authentication Code) verification–configure that here

Description: Apply a backend description for your configuration for reference

Next set your Authentication Type and add in any Authentication Data necessary for verification

Finally, save the page. Now that you have a webhook configuration your server will receive webhooks each time applicable trigger occurs.

image (2).png

 

Example Webhook Content

{
  "payload": {
    "webhookName": "Test Webhooks",
    "webhookType": "Order Create Complete",
    "tickets": {
      "60000": {
        "address2": "",
        "attendeeBirthDay": "1",
        "attendeeBirthMonth": "1",
        "attendeeBirthYear": "1990",
        "attendeeCompany": "",
        "attendeeEmailAddress": "test@test.com",
        "attendeeFirstName": "First",
        "attendeeLastName": "Last",
        "attendeePhone": "",
        "attendeeQuestions": [
          {
            "id": "3465",
            "ticketId": "61433",
            "questionId": "107",
            "answerId": "762",
            "answerText": "Medium",
            "dynamicQuantity": "2",
            "displayText": "Medium",
            "lastUpdate": "1749055233",
            "sku": "Shirt-MD",
            "addOnId": "1288",
            "amount": "18.00",
            "originalAmount": "18.00",
            "originalAnswerId": "762",
            "individualServiceFee": "0.00",
            "individualThirdPartyFee": "0.00",
            "individualProcessingFee": "0.56",
            "hasAddOn": true
          }
        ],
        "attendeeTitle": "",
        "barcode": "HI55210121282605",
        "bibNumber": "",
        "billingAddress": "123 Fake St",
        "billingAddress2": "#215",
        "billingCity": "New Beach",
        "billingCountry": "",
        "billingEmail": "",
        "billingFirstName": "First",
        "billingLastName": "Last",
        "billingPhone": "+99999999999",
        "billingState": "NY",
        "billingSuburb": "",
        "billingZip": "99999",
        "captainsTicketId": null,
        "childEventId": null,
        "chipNumber": "",
        "claimantEmailAddress": null,
        "claimantUserId": null,
        "claimedTimestamp": null,
        "deleted": "0",
        "emergencyContactName": "",
        "emergencyContactNumber": "",
        "eventId": "101958",
        "externalEventId": "19262023",
        "externalMembershipId": null,
        "forPurchaser": null,
        "gender": "male",
        "gratuityAmount": "0.00",
        "guid": "A891FAD6-29AB-4F6A-BF52-0ED9DE71DD45",
        "individualProcessingFee": "0.39",
        "individualServiceFee": "0.00",
        "individualThirdPartyFee": "1.00",
        "internalTransactionId": "3428",
        "lastUpdate": "1749055238",
        "linkToUser": "0",
        "localizationId": "3",
        "orderHash": "645c1d0f9096c36c63a34d06a3f96dcd",
        "orderId": "65605",
        "originalPrice": "2.00",
        "originalShippingCharge": "0.00",
        "paidUponCheckout": "2.00",
        "passCode": null,
        "passType": null,
        "paymentMethod": "credit",
        "pendingDirectBankPayment": "1",
        "premadeBarcodeId": "0",
        "price": "2.00",
        "priceRuleId": "0",
        "processState": "0",
        "promoCode": null,
        "promoCodeUsed": "0",
        "promoterId": "",
        "promoterParent": "0",
        "purchaseDate": "1749055210",
        "purchaseLocation": "frontEnd",
        "purchasePhone": "+99999999999",
        "purchaserEmailAddress": "webhook@ticketsocket.com",
        "purchaserExternalId": "399c8bd6-be37-ee11-bdf4-000d3a314be4",
        "purchaserFirstName": "First",
        "purchaserLastName": "Last",
        "referredBy": "",
        "refundDate": "0",
        "refundTransactionId": "",
        "remoteAddr": "35.143.199.76",
        "saleByAdmin": "0",
        "scannedTimestamp": "0",
        "serviceFeePaid": "0.00",
        "serviceFeeShown": "0.00",
        "shipping": "2",
        "shippingAddress": "123 Fake St",
        "shippingCharge": "0.00",
        "shippingCity": "New Beach",
        "shippingCountry": "US",
        "shippingState": "NY",
        "shippingZip": "99999",
        "taxAmount": "0.00",
        "teamId": "0",
        "teamName": null,
        "thePaymentMethod": "credit",
        "thirdPartyFeeAmount": "2.00",
        "thirdPartyFeeName": "",
        "ticketHash": "1a6851aced184ab999999e54f10694c8",
        "ticketId": "61433",
        "ticketPassUsedId": null,
        "ticketTypeName": "General Admission",
        "transferState": "",
        "typeId": "6717",
        "upgradeState": "",
        "userId": "1309",
        "waiverSigned": null,
        "waveTimeId": null,
        "waveTimeName": null,
        "waveTimeStartTimestamp": null,
        "withdrawnState": ""
      },
      "61434": {
        "address2": "",
        "attendeeBirthDay": "1",
        "attendeeBirthMonth": "1",
        "attendeeBirthYear": "1990",
        "attendeeCompany": "",
        "attendeeEmailAddress": "webhook@ticketsocket.com",
        "attendeeFirstName": "First",
        "attendeeLastName": "Last",
        "attendeePhone": "",
        "attendeeQuestions": [
          {
            "id": "3466",
            "ticketId": "61434",
            "questionId": "104",
            "answerId": "738",
            "answerText": "XX-Large",
            "dynamicQuantity": "0",
            "displayText": "XX-Large",
            "lastUpdate": "1749055233",
            "sku": "",
            "addOnId": "1289",
            "amount": "25.00",
            "originalAmount": "25.00",
            "originalAnswerId": "738",
            "individualServiceFee": "0.00",
            "individualThirdPartyFee": "0.00",
            "individualProcessingFee": "0.77",
            "hasAddOn": true
          }
        ],
        "attendeeTitle": "",
        "barcode": "HI55210307889605",
        "bibNumber": "",
        "billingAddress": "123 Fake St",
        "billingAddress2": "#215",
        "billingCity": "New Beach",
        "billingCountry": "",
        "billingEmail": "",
        "billingFirstName": "First",
        "billingLastName": "Last",
        "billingPhone": "+14075923989",
        "billingState": "NY",
        "billingSuburb": "",
        "billingZip": "99999",
        "captainsTicketId": null,
        "childEventId": null,
        "chipNumber": "",
        "claimantEmailAddress": null,
        "claimantUserId": null,
        "claimedTimestamp": null,
        "deleted": "0",
        "emergencyContactName": "",
        "emergencyContactNumber": "",
        "eventId": "101958",
        "externalEventId": "19262023",
        "externalMembershipId": null,
        "forPurchaser": null,
        "gender": "male",
        "gratuityAmount": "0.00",
        "guid": "D55E2B8E-2D2A-4D27-8D35-7035603FCA28",
        "individualProcessingFee": "0.19",
        "individualServiceFee": "0.00",
        "individualThirdPartyFee": "1.00",
        "internalTransactionId": "3428",
        "lastUpdate": "1749055238",
        "linkToUser": "0",
        "localizationId": "3",
        "orderHash": "645c1d0f9096c36c63a34d06a3f96dcd",
        "orderId": "65605",
        "originalPrice": "5.00",
        "originalShippingCharge": "0.00",
        "paidUponCheckout": "5.00",
        "passCode": null,
        "passType": null,
        "paymentMethod": "credit",
        "pendingDirectBankPayment": "1",
        "premadeBarcodeId": "0",
        "price": "5.00",
        "priceRuleId": "0",
        "processState": "0",
        "promoCode": null,
        "promoCodeUsed": "0",
        "promoterId": "",
        "promoterParent": "0",
        "purchaseDate": "1749055210",
        "purchaseLocation": "frontEnd",
        "purchasePhone": "+14075923989",
        "purchaserEmailAddress": "webhook@ticketsocket.com",
        "purchaserExternalId": "399c8bd6-be37-ee11-bdf4-000d3a314be4",
        "purchaserFirstName": "First",
        "purchaserLastName": "Last",
        "referredBy": "",
        "refundDate": "0",
        "refundTransactionId": "",
        "remoteAddr": "00.000.000.00",
        "saleByAdmin": "0",
        "scannedTimestamp": "0",
        "serviceFeePaid": "0.00",
        "serviceFeeShown": "0.00",
        "shipping": "2",
        "shippingAddress": "123 Fake St",
        "shippingCharge": "0.00",
        "shippingCity": "123 Fake St",
        "shippingCountry": "US",
        "shippingState": "NY",
        "shippingZip": "99999",
        "taxAmount": "0.00",
        "teamId": "0",
        "teamName": null,
        "thePaymentMethod": "credit",
        "thirdPartyFeeAmount": "2.00",
        "thirdPartyFeeName": "",
        "ticketHash": "54ac113202b68ff28ebfe94f49f0df54",
        "ticketId": "61434",
        "ticketPassUsedId": null,
        "ticketTypeName": "General Admission",
        "transferState": "",
        "typeId": "6718",
        "upgradeState": "",
        "userId": "1309",
        "waiverSigned": null,
        "waveTimeId": null,
        "waveTimeName": null,
        "waveTimeStartTimestamp": null,
        "withdrawnState": ""
      }
    }
  },
  "hash": "5ebbeb0e47294ab9eceff66f5f32d96c"
}