Order Notifications (Webhooks)
Description | Notifications System can be used to update you about new orders as well as changes to an order. |
|---|
Webhooks are sent as an application/x-www-form-urlencoded POST to a URL which you provide to TEvo. All webhooks will include an order_group_id, recipient, event_type, and body.
In order to receive webhooks you will need to provide a URL for us to input. There will be no expected response with webhooks.
We have notifications that apply to both Sellers and Buyers and the recipient parameter indicates whether you are the buyer or the seller for the given order.
If you wish to use webhooks in Sandbox or Production contact our support team to provide us the URL.
The Order Notification webhook url is shared with Catalog Notifications. You need to triage incoming events based on event_type
- 1 Seller Notifications
- 2 Buyer Notifications
- 2.1 Order Accepted
- 2.2 Order Canceled
- 2.3 Order Rejected
- 2.4 ETicket Finalized
- 2.5 In-Hand Updated
- 2.6 Airbill Requested
- 2.7 Airbill Generated
- 2.8 Delivery Reclassified
- 2.9 Delivery Updated
- 2.10 Delivery Shipped
- 2.11 Delivery Complete
- 2.12 Proof of Transfer Uploaded
- 3 Whitelisting IPs
- 3.1 Authentication
Seller Notifications
New Order/Fraud Response Received
As soon as a new order for your tickets is received we will send these notifications. This should reduce your reliance on checking Orders / Index for new orders, and once you have confirmed this notification is working for you we suggest that only check Orders / Index every 5 minutes or so as a fallback.
recipient | event_type | body |
|---|---|---|
|
|
|
Airbill Uploaded
When a buyer has purchased Physical tickets to be shipped and used the delivery type ProvidedAirbill to indicate they would upload an airbill we will send this notification when the airbill is uploaded and is ready for you to retrieve using Shipments / Get Airbill or manually via Core.
recipient | event_type | body |
|---|---|---|
|
|
|
Delivery Updated
When the delivery has detail or attribute changes post-order (email address, name, etc…), we will send this notification.
recipient | event_types | body |
|---|---|---|
|
|
|
Order Accepted
When you have Accepted an order we will send this notification.
recipient | event_type | body |
|---|---|---|
|
|
|
Order Canceled
When an order is canceled for any reason, we will send this notification.
recipient | event_type | body |
|---|---|---|
|
| {
"id": 123456789,
"oid": "1234567-123456789",
"order_type": "direct",
"placer": {
"id": 1692,
"url": "/offices/1692",
"address": {
"id": 6571852,
"label": null,
"name": null,
"street_address": "2700 South Quincy Street",
"extended_address": "Suite 225",
"cross_street": null,
"po_box": false,
"locality": "Arlington",
"region": "VA",
"postal_code": "22206",
"country_code": "US",
"latitude": null,
"longitude": null,
"primary": false
},
"brokerage": {
"id": 1700,
"url": "/brokerages/1700",
"name": "Auto-Purchase",
"abbreviation": "TEvo Seller",
"natb_member": false,
"email": "sales@ticketevolution.com",
"created_at": "2013-01-10T16:42:20Z",
"updated_at": "2025-03-10T19:13:45Z",
"master": false
},
"email_address": "sales@ticketevolution.com",
"phone": "972-468-9750",
"evopay": false,
"type": "Office",
"name": "Auto-Purchase",
"pcc_code": null
},
"buyer": {
"id": 6,
"url": "/offices/6",
"address": {
"id": 9055343,
"label": null,
"name": null,
"street_address": "2788 South Arlington Mill Drive",
"extended_address": "Suite 275",
"cross_street": null,
"po_box": false,
"locality": "Arlington",
"region": "VA",
"postal_code": "22206",
"country_code": "US",
"latitude": null,
"longitude": null,
"primary": false
},
"brokerage": {
"id": 61,
"url": "/brokerages/61",
"name": "Ticket Evolution",
"abbreviation": "Ticket Evolution",
"natb_member": false,
"email": "billing@ticketevolution.com",
"created_at": "2010-07-28T12:02:16Z",
"updated_at": "2025-08-25T21:46:39Z",
"master": true
},
"email_address": "evohelp@ticketevolution.com",
"phone": "972-468-9750",
"evopay": true,
"type": "Office",
"name": "Main Office",
"pcc_code": null
},
"seller": {
"id": 1234,
"url": "/offices/1234",
"address": {
"id": 23456789,
"label": null,
"name": null,
"street_address": "123 Main Street",
"extended_address": "",
"cross_street": null,
"po_box": false,
"locality": "New York",
"region": "NY",
"postal_code": "10001",
"country_code": "US",
"latitude": null,
"longitude": null,
"primary": false
},
"brokerage": {
"id": 23456,
"url": "/brokerages/23456",
"name": "Test Brokerage",
"abbreviation": "Test",
"natb_member": false,
"email": "test@test.com",
"created_at": "2025-08-08T16:04:41Z",
"updated_at": "2025-12-15T18:09:30Z",
"master": false
},
"email_address": "test@test.com",
"phone": "888-888-8888",
"evopay": true,
"type": "Office",
"name": "API",
"pcc_code": null
},
"client": null,
"billing_address": {
"id": 9055343,
"label": null,
"name": null,
"street_address": "2788 South Arlington Mill Drive",
"extended_address": "Suite 275",
"cross_street": null,
"po_box": false,
"locality": "Arlington",
"region": "VA",
"postal_code": "22206",
"country_code": "US",
"latitude": null,
"longitude": null,
"primary": false
},
"shipping_address": null,
"seller_is_pos": false,
"substitute_order_link_id": null,
"minfraud_response": null,
"was_auto_pended": null,
"was_auto_accepted": null,
"was_auto_canceled": null,
"created_by_ip_address": "1.2.3.4",
"created_by": {
"brokerage_id": 34567,
"label": "",
"office_id": null,
"type": "ApiCredential"
},
"spec": false,
"isPO": false,
"is_new_inventory": null,
"spec_fulfilled": false,
"fraud_check_status": null,
"promo_code": null,
"items": [
{
"id": 345678910,
"order_item_id": 4567891011,
"order_item_link_id": 345678910,
"order_id": 123456789,
"created_at": "2026-01-26T19:20:09Z",
"updated_at": "2026-01-26T19:36:03Z",
"price": "92.0",
"cost": "",
"quantity": 1,
"eticket_delivery": false,
"eticket_available": false,
"eticket_updated_at": null,
"eticket_downloaded_at": null,
"eticket_downloaded_by": null,
"eticket_finalized": null,
"eticket_finalized_at": null,
"eticket_pdf_pages": null,
"eticket_file_size": null,
"needs_eticket": false,
"needs_sub": true,
"seats": [481],
"eticket_thumbnails": [],
"has_spec_tickets": false,
"ticket_group": {
"id": "56789101112",
"url": "/ticket_groups/56789101112",
"quantity": 1,
"retail_price": "92.0",
"wholesale_price": "93.38",
"face_value": "79.0",
"office_id": 1692,
"office_name": "Auto-Purchase",
"brokerage_id": 1700,
"brokerage_name": "Auto-Purchase",
"remote_id": "678910111213",
"external_notes": null,
"section": "ORCHR",
"row": "UU",
"format": "TM_mobile",
"seats": ["481"],
"in_hand": "false",
"in_hand_on": "2026-06-26",
"instant_delivery": false,
"seller_email": null,
"tickets": [{ "seat": "481", "purchase_order_id": null }],
"event": {
"id": 982604,
"url": "/events/982604",
"name": "Test Event",
"occurs_at": "2026-06-27T20:00:00Z",
"venue": {
"id": 1188,
"name": "Test Venue - NY",
"address": { "locality": "New York", "region": "NY" }
}
}
}
}
],
"payments": [
{
"id": 789101112,
"type": "evopay",
"credit_card": null,
"amount": "92.0",
"avs_response": "",
"avs_response_code": "",
"avs_street_address_response": "",
"avs_street_address_response_code": "",
"avs_postal_code_response": "",
"avs_postal_code_response_code": "",
"cvv_response": "",
"cvv_response_code": "",
"order_link_id": 123456789,
"performed_by": null,
"created_at": "2026-01-26T19:20:23Z",
"updated_at": "2026-01-26T19:20:23Z",
"state": "canceled",
"is_refund": false,
"refunded_from_id": null,
"check_number": null,
"credit_memo_id": null,
"payment_for_credit_memo_id": null,
"url": "/payments/789101112"
}
],
"pending_non_refund_payments_total": 0,
"completed_non_refund_payments_total": 0,
"pending_balance": "92.0",
"substitutions": [],
"notes": [],
"shipping": "0.0",
"shipments": [
{
"id": 8910111213,
"url": "/shipments/8910111213",
"type": "TBD",
"state": "pending",
"cost": "0.0",
"courier_company": null,
"tracking_number": null,
"tracking_url": null,
"transfer_source": null,
"phone_number": null,
"service_type": "LEAST_EXPENSIVE",
"service_type_display": null,
"items": [
{
"id": 4567891011,
"quantity": 1,
"eticket_delivery": false,
"eticket_available": true,
"eticket_downloaded_at": "",
"eticket_downloaded_by": null,
"ticket_group": {
"id": "56789101112",
"wholesale_price": "93.38",
"remote_id": "678910111213",
"external_notes": null,
"seats": ["481"],
"quantity": 1,
"office_id": "1234",
"event": {
"id": "982604",
"name": "Test Event",
"occurs_at": "2026-06-27T20:00:00Z",
"venue": {
"id": "1188",
"name": "Test Venue - NY",
"address": {}
}
},
"section": "ORCHR",
"row": "UU",
"retail_price": "92.0"
},
"updated_at": "2026-01-26T19:36:03Z",
"price": "92.0"
}
],
"name": null,
"ship_to_name": null,
"ship_to_company_name": null,
"ship_from_name": null,
"ship_from_address": null,
"ship_from_phone_number": null,
"pickup_time_range": null,
"pickup_instructions": null,
"signature_type": "",
"updated_at": "2026-01-26T19:20:09Z",
"shipment_snapshot": {
"id": 8910111213,
"type": "TBD",
"po_box": null,
"locality": null,
"postal_code": null,
"region": null,
"country_code": null,
"available": null,
"carrier": null
},
"carrier": null,
"available": false,
"notes": null,
"buyer_edit_count": 0,
"seller_edit_count": 0,
"tm_mobile_link": null,
"email_address": {},
"transfer_verifications": [],
"airbill": "/airbills/original/missing.png"
}
],
"child_orders": [],
"patron_type": "Office",
"service_fee": "0.0",
"additional_expense": "0.0",
"discount": "0.0",
"insurance": "0.0",
"tax": "0.0",
"fee": "5.52",
"subtotal": "92.0",
"total": "92.0",
"refunded": "0.0",
"returns_total": 0.0,
"penalties_total": 0.0,
"balance": "92.0",
"partner": true,
"instructions": null,
"state": "canceled",
"buyer_state": "accepted",
"seller_state": "canceled",
"consignment": false,
"seller_cancellation_reason": "Time Limit Exceeded",
"buyer_cancellation_reason": null,
"seller_cancellation_notes": "",
"buyer_cancellation_notes": null,
"seller_rejection_reason": "No suitable replacement found",
"buyer_rejection_reason": null,
"seller_rejection_notes": "Admin couldn’t locate suitable replacement tickets",
"buyer_rejection_notes": null,
"created_at": "2026-01-26T19:20:09Z",
"updated_at": "2026-01-26T19:36:02Z",
"reference": null,
"url": "/orders/123456789",
"shipment_snapshot": [
{
"id": 8910111213,
"type": "TBD",
"po_box": null,
"locality": null,
"postal_code": null,
"region": null,
"country_code": null,
"available": null,
"carrier": null
}
],
"oth_created": false
}
|
Etickets Finalized
When you have uploaded and finalized Etickets for an order item we will send this notification.
recipient | event_type | body |
|---|---|---|
|
|
|
In-Hand Updated
When the in hand or in hand on changes on an order, we will send this notification.
recipient | event_type | body |
|---|---|---|
|
|
|
Order Rejected
When you have Rejected an order we will send this notification.
recipient | event_type | body |
|---|---|---|
|
|
|
Proof of Transfer Requested
A Proof of Transfer requested notification is sent when you are the seller, the associated order shipment is complete, but no Proof of Transfer has been uploaded
recipient | event_type | body |
|---|---|---|
|
| {
"transfer_verification": {
"id": 12345,
"type": "Proof of Transfer",
"uploads": [],
"created_at": "<iso8601-datetime-string>",
"updated_at": "<iso8601-datetime-string>"
}
} |
Buyer Notifications
Order Accepted
When a Seller accepts a Purchase Order you have sent you will receive this notification.
recipient | event_type | body |
|---|---|---|
|
|
|
Order Canceled
When an order is canceled for any reason, we will send this notification.
recipient | event_type | body |
|---|---|---|
|
| {
"id":987654321,
"oid":"12345678-987654321",
"order_type":"direct",
"placer":{
"id":1692,
"url":"/offices/1692",
"address":{
"id":6571852,
"label":null,
"name":null,
"street_address":"2700 South Quincy Street",
"extended_address":"Suite 225",
"cross_street":null,
"po_box":false,
"locality":"Arlington",
"region":"VA",
"postal_code":"22206",
"country_code":"US",
"latitude":null,
"longitude":null,
"primary":false
},
"brokerage":{
"id":1700,
"url":"/brokerages/1700",
"name":"Auto-Purchase",
"abbreviation":"TEvo Seller",
"natb_member":false,
"email":"sales@ticketevolution.com",
"created_at":"2013-01-10T16:42:20Z",
"updated_at":"2025-03-10T19:13:45Z",
"master":false
},
"email_address":"sales@ticketevolution.com",
"phone":"972-468-9750",
"evopay":false,
"type":"Office",
"name":"Auto-Purchase",
"pcc_code":null
},
"buyer":{
"id":1234,
"url":"/offices/1234",
"address":{
"id":234567,
"label":null,
"name":null,
"street_address":"123 Main Street",
"extended_address":"",
"cross_street":null,
"po_box":false,
"locality":"New York",
"region":"NY",
"postal_code":"10001",
"country_code":"US",
"latitude":null,
"longitude":null,
"primary":false
},
"brokerage":{
"id":2345,
"url":"/brokerages/2345",
"name":"Test Brokerage",
"abbreviation":"Test",
"natb_member":false,
"email":"test@test.com",
"created_at":"2014-10-01T17:52:45Z",
"updated_at":"2025-07-15T19:26:43Z",
"master":false
},
"email_address":"orders@test.com",
"phone":"888.888.8888",
"evopay":true,
"type":"Office",
"name":"Main Office",
"pcc_code":null
},
"seller":{
"id":6,
"url":"/offices/6",
"address":{
"id":9055343,
"label":null,
"name":null,
"street_address":"2788 South Arlington Mill Drive",
"extended_address":"Suite 275",
"cross_street":null,
"po_box":false,
"locality":"Arlington",
"region":"VA",
"postal_code":"22206",
"country_code":"US",
"latitude":null,
"longitude":null,
"primary":false
},
"brokerage":{
"id":61,
"url":"/brokerages/61",
"name":"Ticket Evolution",
"abbreviation":"Ticket Evolution",
"natb_member":false,
"email":"billing@ticketevolution.com",
"created_at":"2010-07-28T12:02:16Z",
"updated_at":"2025-08-25T21:46:39Z",
"master":true
},
"email_address":"evohelp@ticketevolution.com",
"phone":"972-468-9750",
"evopay":true,
"type":"Office",
"name":"Main Office",
"pcc_code":null
},
"client":null,
"billing_address":{
"id":234567,
"label":null,
"name":null,
"street_address":"123 Main Street",
"extended_address":"",
"cross_street":null,
"po_box":false,
"locality":"New York",
"region":"NY",
"postal_code":"10001",
"country_code":"US",
"latitude":null,
"longitude":null,
"primary":false
},
"shipping_address":{
"id":234567,
"label":null,
"name":null,
"street_address":"123 Main Street",
"extended_address":"",
"cross_street":null,
"po_box":false,
"locality":"New York",
"region":"NY",
"postal_code":"10001",
"country_code":"US",
"latitude":null,
"longitude":null,
"primary":false
},
"seller_is_pos":true,
"substitute_order_link_id":null,
"minfraud_response":null,
"was_auto_pended":null,
"was_auto_accepted":null,
"was_auto_canceled":true,
"created_by_ip_address":null,
"created_by":{
"brokerage_id":2345,
"label":"TestBrokerageApp",
"office_id":null,
"type":"ApiCredential"
},
"spec":false,
"isPO":true,
"is_new_inventory":null,
"spec_fulfilled":false,
"fraud_check_status":null,
"promo_code":null,
"items":[
{
"id":3456789,
"order_item_id":45678910,
"order_item_link_id":3456789,
"order_id":987654321,
"created_at":"2026-01-26T23:40:43Z",
"updated_at":"2026-01-27T00:00:51Z",
"price":"131.0",
"cost":"655.0",
"quantity":5,
"eticket_delivery":false,
"eticket_available":false,
"eticket_updated_at":null,
"eticket_downloaded_at":null,
"eticket_downloaded_by":null,
"eticket_finalized":null,
"eticket_finalized_at":null,
"eticket_pdf_pages":null,
"eticket_file_size":null,
"needs_eticket":false,
"needs_sub":true,
"seats":[
6,
8,
10,
12,
14
],
"eticket_thumbnails":[
],
"has_spec_tickets":false,
"ticket_group":{
"id":"567891011",
"url":"/ticket_groups/567891011",
"quantity":5,
"retail_price":"131.0",
"wholesale_price":"131.0",
"face_value":"69.0",
"office_id":1692,
"office_name":"Auto-Purchase",
"brokerage_id":1700,
"brokerage_name":"Auto-Purchase",
"remote_id":"6789101212",
"external_notes":"Transfer",
"section":"MEZZANINE RIGHT",
"row":"E",
"format":"TM_mobile",
"seats":[
"6",
"8",
"10",
"12",
"14"
],
"in_hand":"false",
"in_hand_on":"2026-02-02",
"instant_delivery":false,
"seller_email":null,
"tickets":[
{
"seat":"6",
"purchase_order_id":null
},
{
"seat":"8",
"purchase_order_id":null
},
{
"seat":"10",
"purchase_order_id":null
},
{
"seat":"12",
"purchase_order_id":null
},
{
"seat":"14",
"purchase_order_id":null
}
],
"event":{
"id":982604,
"url":"/events/982604",
"name":"Test Event",
"occurs_at":"2026-02-03T19:30:00Z",
"venue":{
"id":1188,
"name":"Test Venue",
"address":{
"locality":"New York",
"region":"NY"
}
}
}
}
}
],
"payments":[
],
"pending_non_refund_payments_total":0,
"completed_non_refund_payments_total":0,
"pending_balance":"655.0",
"substitutions":[
],
"notes":[
],
"shipping":"0.0",
"shipments":[
{
"id":6789101112,
"url":"/shipments/6789101112",
"type":"TBD",
"state":"pending",
"cost":"0.0",
"courier_company":null,
"tracking_number":null,
"tracking_url":null,
"transfer_source":null,
"phone_number":null,
"service_type":"LEAST_EXPENSIVE",
"service_type_display":null,
"items":[
{
"id":45678910,
"quantity":5,
"eticket_delivery":false,
"eticket_available":true,
"eticket_downloaded_at":"",
"eticket_downloaded_by":null,
"ticket_group":{
"id":"567891011",
"wholesale_price":"131.0",
"remote_id":"6789101212",
"external_notes":"Transfer",
"seats":[
"6",
"8",
"10",
"12",
"14"
],
"quantity":5,
"office_id":"654321",
"event":{
"id":"982604",
"name":"Test Event",
"occurs_at":"2026-02-03T19:30:00Z",
"venue":{
"id":"1188",
"name":"Test Venue",
"address":{
}
}
},
"section":"MEZZANINE RIGHT",
"row":"E",
"retail_price":"131.0"
},
"updated_at":"2026-01-27T00:00:51Z",
"price":"131.0"
}
],
"name":null,
"ship_to_name":"Test User",
"ship_to_company_name":null,
"ship_from_name":null,
"ship_from_address":null,
"ship_from_phone_number":null,
"pickup_time_range":null,
"pickup_instructions":null,
"signature_type":"",
"updated_at":"2026-01-26T23:40:43Z",
"shipment_snapshot":{
"id":6789101112,
"type":"TBD",
"po_box":null,
"locality":null,
"postal_code":null,
"region":null,
"country_code":null,
"available":null,
"carrier":null,
"name":null,
"company":null,
"label":null,
"email_address":"test@test.com",
"phone_number":null,
"street_address":null,
"extended_address":null,
"cross_street":null
},
"carrier":null,
"available":false,
"notes":null,
"buyer_edit_count":0,
"seller_edit_count":0,
"tm_mobile_link":null,
"email_address":{
"id":9632127,
"url":null,
"address":"test@test.com",
"label":null,
"updated_at":"2026-01-26T23:40:43Z"
},
"transfer_verifications":[
],
"airbill":"/airbills/original/missing.png"
}
],
"child_orders":[
17896213
],
"patron_type":"Office",
"service_fee":"0.0",
"additional_expense":"0.0",
"discount":"0.0",
"insurance":"0.0",
"tax":"0.0",
"fee":"0.0",
"subtotal":"655.0",
"total":"655.0",
"refunded":"0.0",
"returns_total":0.0,
"penalties_total":0.0,
"balance":"655.0",
"partner":true,
"instructions":null,
"state":"canceled",
"buyer_state":"accepted",
"seller_state":"canceled",
"consignment":false,
"seller_cancellation_reason":"Time Limit Exceeded",
"buyer_cancellation_reason":null,
"seller_cancellation_notes":"Auto canceled due to buyer auto-cancel pending order time preferences.",
"buyer_cancellation_notes":null,
"seller_rejection_reason":null,
"buyer_rejection_reason":null,
"seller_rejection_notes":null,
"buyer_rejection_notes":null,
"created_at":"2026-01-26T23:40:43Z",
"updated_at":"2026-01-27T00:00:56Z",
"reference":null,
"url":"/orders/987654321",
"shipment_snapshot":[
{
"id":6789101112,
"type":"TBD",
"po_box":null,
"locality":null,
"postal_code":null,
"region":null,
"country_code":null,
"available":null,
"carrier":null,
"name":null,
"company":null,
"label":null,
"email_address":"test@test.com",
"phone_number":null,
"street_address":null,
"extended_address":null,
"cross_street":null
}
],
"oth_created":false
} |
Order Rejected
When a Seller has Rejected a Purchase Order you have sent you will receive this notification.
recipient | event_type | body |
|---|---|---|
|
|
|
ETicket Finalized
Once the Seller has uploaded the Etickets for an item within your Purchase Order you will receive this notification.
recipient | event_type | body |
|---|---|---|
|
|
|
In-Hand Updated
When the in hand or in hand on changes on an order, we will send this notification.
recipient | event_type | body |
|---|---|---|
|
|
|
Airbill Requested
When a Seller has requested an airbill because they are ready to ship Physical tickets we will send this notification. See below for notification example.
Airbill Generated
When a Seller has generated an airbill because they are ready to ship Physical tickets we will send this notification. See below for notification example.
Delivery Reclassified
When the delivery method has changed post-order (ex: from Fedex to Local Pickup, etc…), we will send this notification. See below for notification example.
Delivery Updated
When the delivery has detail or attribute changes post-order (email address, name, etc…), we will send this notification. See below for notification example.
Delivery Shipped
When FedEx shows that they have taken possession of a package we will send this notification. See below for notification example.
Delivery Complete
This notification is sent when:
Physical tickets are shown as delivered via FedEx
Etickets are uploaded into the system
Transferrable tickets (Flash and TM Mobile) have been transferred
When the information for Local Pickup, Will Call, or Guest List has been exchanged
recipient | event_types | body |
|---|---|---|
|
|
|
Proof of Transfer Uploaded
A Proof of Transfer Uploaded notification is sent when an order has been accept or completed and Proof of Transfer is provided by the seller.
recipient | event_type | body |
|---|---|---|
|
| {
"transfer_verification": {
"id": 1234,
"type": "Proof of Transfer",
"links": [
"<link-to-downloadable-url>",
"<link-to-downloadable-url>"
],
"created_at": "DD/MM/YYYY HH:MM",
}
} |
Whitelisting IPs
Authentication
In the event you would like to ensure that the webhook calls are coming from TEvo, we recommend whitelisting our IP addresses.
Sandbox/Production:
18.235.211.7
35.170.152.168