Skip to content

Locker Webhook Events

When subscribed to tracking events for Locker APIs, you will receive a JSON each time there is a status update.

Below are the examples of a Webhook event :

Locker Webhook SQS events by activity type

1. Reservation

{
  "activityCode": "reservation",
  "activityDate": "2026-06-08T08:09:46.00001068Z",
  "contactId": "684a6b7bbc85e1bce73xxxxx",
  "contactType": "recipient",
  "depositorAccessCode": "OTACE7EDNR",
  "depositorContactId": "6a2678b5a07ad165349xxxxx",
  "depositorContactType": "recipient",
  "lockerBankId": "LB-AONE-001",
  "lockerUnitId": "12",
  "photo": {
    "base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",
    "contentType": "image/png"
  },
  "signature": {
    "base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",
    "contentType": "image/png"
  },
  "subId": "xxxxxx",
  "trackingNumber": "1Z999AA10123456XXX",
  "secondaryTrackingNumber": "9405511899223197428507",
  "transactionType": "return",
  "userId": "thridparty"
}

2. Update reservation

{
  "activityCode": "updatereservation",
  "activityDate": "2026-06-12T14:12:07Z",
  "contactId": "684a6b7bbc85e1bce73xxxxx",
  "contactType": "recipient",
  "lockerBankId": "LB-AONE-001",
  "lockerUnitId": "2",
  "photo": {},
  "signature": {},
  "subId": "xxxxxx",
  "trackingNumber": "1Z999AA10123456XXX",
  "transactionType": "deliver",
  "userId": "thridpartyuser@yopmail.com"
}

3. Cancel Reservation

{
  "activityCode": "cancelreservation",
  "activityDate": "2026-06-12T14:14:39.934260457Z",
  "contactId": "684a6b7bbc85e1bce73xxxxx",
  "contactType": "recipient",
  "lockerBankId": "LB-AONE-001",
  "lockerUnitId": "2",
  "photo": {},
  "signature": {},
  "subId": "xxxxxx",
  "trackingNumber": "1Z999AA10123456XXX",
  "transactionType": "deliver",
  "userId": "ThirdParty"
}

4. Deposit

{
  "activityCode": "deposit",
  "activityDate": "2026-06-12T14:16:07.697006627Z",
  "contactId": "684a6b7bbc85e1bce73xxxxx",
  "contactType": "recipient",
  "lockerBankId": "LB-AONE-001",
  "lockerUnitId": "2",
  "photo": {
    "base64": "/9j/4AAQSkZJRgABAQAAAQABAAD/ //AABEIAf8D6AMBIgACEQEDEQH/xAAVAAEBAAAAAAAAAAAAAAAAAAAABv/ /EABQRAQAAAAAAAAAAAAAAAAAAAAD/2gAMAwEAAhEDEQA/AIgAAAABQAAAAAAAAAAAQAFABAAUAAAAAEABQAQAAAFAAAAAAQEABQAAAQAFAAAAAAAAAAABAAUAEAAABQAQAAAFAAABAAAAAAUAAAEAAAAABQAQAAAAAAAAAFABAAAAUAEAAH/2Q==",
    "contentType": "image/jpeg"
  },
  "signature": {},
  "subId": "xxxxxx",
  "trackingNumber": "1Z999AA10123456XXX",
  "transactionType": "deliver",
  "userId": "thirdpartyuser@gmail.com"
}

5. Recipient Pickup

{
  "activityCode": "pickup",
  "activityDate": "2026-06-11T17:24:31.564903411Z",
  "contactId": "684a6b7bbc85e1bce73xxxxx",
  "contactType": "recipient",
  "lockerBankId": "LB-AONE-001",
  "lockerUnitId": "7",
  "photo": {
    "base64": "4QDKRXhpZgAATU0AKgAAAAgABgESAAMAAAABAAEAAAEaAAUAAAABAAAAVgEbAAUAAAABAAAAXgEoAAMAAAABAAIAAAITAAMAAAABAAEAAIdpAAQAAABAAAAZgAAAAAAAABIAAAAA",
    "contentType": "image/gif"
  },
  "signature": {
    "base64": "4QDKRXhpZgAATU0AKgAAAAgABgESAAMAAAABAAEAAAEaAAUAAAABAAAAVgEbAAUAAAABAAAAXgEoAAMAAAABAAIAAAITAAMAAAABAAEAAIdpAAQAAABAAAAZgAAAAAAAABIAAAAA",
    "contentType": "image/gif"
  },
  "subId": "xxxxxx",
  "trackingNumber": "1Z999AA10123456XXX",
  "transactionType": "deliver",
  "userId": "thirdpartyuser@gmail.com"
}

6. Admin Pickup

{
  "activityCode": "stalemailpickup",
  "activityDate": "2026-06-12T14:36:35.342807875Z",
  "contactId": "684a6b7bbc85e1bce73xxxxx",
  "contactType": "recipient",
  "lockerBankId": "LB-AONE-001",
  "lockerUnitId": "2",
  "photo": {},
  "signature": {},
  "subId": "xxxxxx",
  "trackingNumber": "1Z999AA10123456XXX",
  "transactionType": "deliver",
  "userId": "thirdpartyuser@gmail.com"
}

7. Open locker

{
  "activityCode": "openlocker",
  "activityDate": "2026-04-12T17:08:33.85440614Z",
  "contactId": "684a6b7bbc85e1bce739xxxx",
  "contactType": "recipient",
  "lockerBankId": "App1",
  "lockerUnitId": "1",
  "photo": {},
  "signature": {},
  "subId": "xxxxxxx",
  "trackingNumber": "1Z999AA10123456XXX",
  "transactionType": "deliver",
  "userId": "thirdpartyuser@gmail.com"
}

8. Locker On Hold

{ 
  "activityCode": "onhold", 
  "activityDate": "2026-08-20T05:54:58.70827885Z", 
  "contactId": "684a6b7bbc85e1bce739xxxx", 
  "contactType": "recipient", 
  "lockerBankId": "App1", 
  "lockerUnitId": "9", 
  "photo": {}, 
  "signature": {}, 
  "subId": "xxxxxxx", 
  "trackingNumber": "553323XX", 
  "transactionType": "deliver", 
  "userId": "AdminUser@youmail.com" 
}