Event Types

Written by Jarad on March 20, 2023

Webhooks should be configured to receive only the types of events required by your application or integration. Listening for extra events (or all events) will put undue strain on your server and is not recommended.

You can change the events a webhook URL will receive in the account webhook settings or with the API.

Available Event Types

Event Name	Sent When
acquisition.committed Sample	A pending acquisition is committed to the A&D record.
contact.created	A new contact is created.
contact.deleted	A contact is deleted.
contact.edited	An existing contact is modified.
disposition.committed Sample	A pending disposition is committed to the A&D record.
disposition.deleted	A pending disposition is deleted.
disposition.edited	A pending disposition is edited.
disposition.items.added Sample	One or more items are added to a pending disposition, including adding items to a 4473.
disposition.items.edited	One or more items on a pending disposition are edited
disposition.items.removed	One or more items are removed from a pending disposition, including removing items from a 4473.
form4473.completed	A 4473 is completed. The webhook body contains an API URL from which to download the 4473 PDF. WARNING: if you store your 4473s in an external service, you may need to download the latest version of the 4473 from the external service directly. The PDF downloaded from FastBound will not reflect any changes made using the external service.
inventory.location.moved	An item is moved to a new location.
inventory.location.verified	An item is verified during a cycle count.
inventory.notfound	An item is “not found” during a cycle count.
item.deleted	When an item is deleted.
item.edited Sample	When an item is edited.
item.imported	When one or more items is successfully imported via CSV file in Settings > Import.
item.undeleted	An item is deleted.
item.undisposed	A disposed item is undisposed.
multiplesalereport.transmitted	A multiple sale report has been successfully transmitted to the ATF, and, if applicable, CLEO and/or the account’s notification list. The webhook body contains an API URL from which to download the multiple sale report PDF.

Sample – acquisition.committed

{
  "id": "132511c8-d32b-4864-9166-94ae2cfcaf53",
  "eventName": "acquisition.committed",
  "accountNumber": 75165,
  "timestampUtc": "2021-01-11T01:06:18.0599182Z",
  "data": {
    "date": "2021-01-10T20:03:06",
    "type": "Purchase",
    "shipmentTrackingNumber": null,
    "invoiceNumber": null,
    "purchaseOrderNumber": null,
    "contact": {
      "id": "ed38ffa7-da02-467d-8c4c-acad00121ee3",
      "externalId": null,
      "fflNumber": "158067072A90327",
      "fflExpires": "2022-01-01T00:00:00",
      "licenseName": "GLOCK INC",
      "tradeName": null,
      "organizationName": null,
      "firstName": null,
      "middleName": null,
      "lastName": null,
      "premiseAddress1": "6000 HIGHLANDS PKWY",
      "premiseAddress2": null,
      "premiseCity": "SMYRNA",
      "premiseState": "GA",
      "premiseZipCode": "300820000",
      "premiseCounty": null,
      "premiseCountry": "US",
      "phoneNumber": "7704321202",
      "fax": null,
      "emailAddress": null
    },
    "items": [
      {
        "id": "feea44a3-2f2d-4af3-9a68-acad001234f0",
        "externalId": null,
        "itemNumber": "00036",
        "status": 1,
        "statusText": "Available",
        "manufacturer": "Glock",
        "countryOfManufacture": "Austria",
        "importer": "Glock INC",
        "type": "Pistol",
        "model": "17",
        "caliber": "9X19",
        "serial": "FPR269",
        "barrelLength": null,
        "overallLength": null,
        "condition": null,
        "location": null,
        "cost": null,
        "price": 499.99,
        "mpn": "PI1750203",
        "upc": "76450350210",
        "sku": "PI1750203"
      },
      {
        "id": "ffea44a3-2f2d-4af3-9a68-acad001234f0",
        "externalId": null,
        "itemNumber": "00037",
        "status": 1,
        "statusText": "Available",
        "manufacturer": "Glock",
        "countryOfManufacture": "Austria",
        "importer": "Glock INC",
        "type": "Pistol",
        "model": "17 Gen 4",
        "caliber": "9X19",
        "serial": "HZN295",
        "barrelLength": null,
        "overallLength": null,
        "condition": null,
        "location": null,
        "cost": null,
        "price": 539.77,
        "mpn": "PG1750203",
        "upc": "76450365203",
        "sku": "PG1750203"
      },
      {
        "id": "00eb44a3-2f2d-4af3-9a68-acad001234f0",
        "externalId": null,
        "itemNumber": "00038",
        "status": 1,
        "statusText": "Available",
        "manufacturer": "Glock",
        "countryOfManufacture": "Austria",
        "importer": "Glock INC",
        "type": "Pistol",
        "model": "19",
        "caliber": "9X19",
        "serial": "CPY726",
        "barrelLength": null,
        "overallLength": null,
        "condition": null,
        "location": null,
        "cost": null,
        "price": 499.99,
        "mpn": "PI1950203",
        "upc": "764503502194",
        "sku": "PI1950203"
      },
      {
        "id": "01eb44a3-2f2d-4af3-9a68-acad001234f0",
        "externalId": null,
        "itemNumber": "00039",
        "status": 1,
        "statusText": "Available",
        "manufacturer": "Glock",
        "countryOfManufacture": "Austria",
        "importer": "Glock INC",
        "type": "Pistol",
        "model": "19 Gen 4",
        "caliber": "9X19",
        "serial": "JZP837",
        "barrelLength": null,
        "overallLength": null,
        "condition": null,
        "location": null,
        "cost": null,
        "price": 540,
        "mpn": "PG1950203",
        "upc": "764503692031",
        "sku": "PG1950203"
      },
      {
        "id": "02eb44a3-2f2d-4af3-9a68-acad001234f0",
        "externalId": null,
        "itemNumber": "00040",
        "status": 1,
        "statusText": "Available",
        "manufacturer": "Glock",
        "countryOfManufacture": "Austria",
        "importer": "Glock INC",
        "type": "Pistol",
        "model": "20 SF",
        "caliber": "10mm",
        "serial": "TGE329",
        "barrelLength": null,
        "overallLength": null,
        "condition": null,
        "location": null,
        "cost": null,
        "price": 545.04,
        "mpn": "PF2050203",
        "upc": "764503662034",
        "sku": "PF2050203"
      }
    ]
  }
}

Sample – disposition.committed

{
  "id": "211d1ded-9f37-4cab-b924-58057b7441d6",
  "eventName": "disposition.committed",
  "accountNumber": 75165,
  "timestampUtc": "2021-01-11T01:13:21.9774615Z",
  "data": {
    "date": "2021-01-10T20:12:36",
    "type": "Sale",
    "ttsn": null,
    "otsn": null,
    "shipmentTrackingNumber": null,
    "invoiceNumber": null,
    "purchaseOrderNumber": null,
    "theftLoss_DiscoveredDate": null,
    "theftLoss_Type": null,
    "theftLoss_ATFIssuedIncidentNumber": null,
    "theftLoss_PoliceIncidentNumber": null,
    "destroyed_Date": null,
    "destroyed_Description": null,
    "destroyed_Witness1": null,
    "destroyed_Witness2": null,
    "contact": {
      "id": "ed38ffa7-da02-467d-8c4c-acad00121ee3",
      "externalId": null,
      "fflNumber": "158067072A90327",
      "fflExpires": "2022-01-01T00:00:00",
      "licenseName": "GLOCK INC",
      "tradeName": null,
      "organizationName": null,
      "firstName": null,
      "middleName": null,
      "lastName": null,
      "premiseAddress1": "6000 HIGHLANDS PKWY",
      "premiseAddress2": null,
      "premiseCity": "SMYRNA",
      "premiseState": "GA",
      "premiseZipCode": "300820000",
      "premiseCounty": null,
      "premiseCountry": "US",
      "phoneNumber": "7704321202",
      "fax": null,
      "emailAddress": null
    },
    "items": [
      {
        "acquisitionType": "Purchase",
        "acquire_Date": "2021-01-10T20:03:06",
        "acquire_License": "158067072A90327",
        "acquire_LicenseName": "GLOCK INC",
        "acquire_LicenseExpires": "2022-01-01T00:00:00",
        "acquire_TradeName": null,
        "acquire_Organization": null,
        "acquire_FirstName": null,
        "acquire_MiddleName": null,
        "acquire_LastName": null,
        "acquire_Address1": "6000 HIGHLANDS PKWY",
        "acquire_Address2": null,
        "acquire_City": "SMYRNA",
        "acquire_State": "GA",
        "acquire_Postal": "300820000",
        "acquire_Country": "US",
        "acquire_PhoneNumber": "7704321202",
        "acquire_Fax": null,
        "acquire_EmailAddress": null,
        "acquire_PurchaseOrderNumber": null,
        "acquire_InvoiceNumber": null,
        "acquire_ShipmentTrackingNumber": null,
        "id": "feea44a3-2f2d-4af3-9a68-acad001234f0",
        "externalId": null,
        "itemNumber": "00036",
        "status": 3,
        "statusText": "Disposed",
        "manufacturer": "Glock",
        "countryOfManufacture": "Austria",
        "importer": "Glock INC",
        "type": "Pistol",
        "model": "17",
        "caliber": "9X19",
        "serial": "FPR269",
        "barrelLength": null,
        "overallLength": null,
        "condition": null,
        "location": null,
        "cost": null,
        "price": 499.99,
        "mpn": "PI1750203",
        "upc": "76450350210",
        "sku": "PI1750203"
      },
      {
        "acquisitionType": "Purchase",
        "acquire_Date": "2021-01-10T20:03:06",
        "acquire_License": "158067072A90327",
        "acquire_LicenseName": "GLOCK INC",
        "acquire_LicenseExpires": "2022-01-01T00:00:00",
        "acquire_TradeName": null,
        "acquire_Organization": null,
        "acquire_FirstName": null,
        "acquire_MiddleName": null,
        "acquire_LastName": null,
        "acquire_Address1": "6000 HIGHLANDS PKWY",
        "acquire_Address2": null,
        "acquire_City": "SMYRNA",
        "acquire_State": "GA",
        "acquire_Postal": "300820000",
        "acquire_Country": "US",
        "acquire_PhoneNumber": "7704321202",
        "acquire_Fax": null,
        "acquire_EmailAddress": null,
        "acquire_PurchaseOrderNumber": null,
        "acquire_InvoiceNumber": null,
        "acquire_ShipmentTrackingNumber": null,
        "id": "ffea44a3-2f2d-4af3-9a68-acad001234f0",
        "externalId": null,
        "itemNumber": "00037",
        "status": 3,
        "statusText": "Disposed",
        "manufacturer": "Glock",
        "countryOfManufacture": "Austria",
        "importer": "Glock INC",
        "type": "Pistol",
        "model": "17 Gen 4",
        "caliber": "9X19",
        "serial": "HZN295",
        "barrelLength": null,
        "overallLength": null,
        "condition": null,
        "location": null,
        "cost": null,
        "price": 539.77,
        "mpn": "PG1750203",
        "upc": "76450365203",
        "sku": "PG1750203"
      },
      {
        "acquisitionType": "Purchase",
        "acquire_Date": "2021-01-10T20:03:06",
        "acquire_License": "158067072A90327",
        "acquire_LicenseName": "GLOCK INC",
        "acquire_LicenseExpires": "2022-01-01T00:00:00",
        "acquire_TradeName": null,
        "acquire_Organization": null,
        "acquire_FirstName": null,
        "acquire_MiddleName": null,
        "acquire_LastName": null,
        "acquire_Address1": "6000 HIGHLANDS PKWY",
        "acquire_Address2": null,
        "acquire_City": "SMYRNA",
        "acquire_State": "GA",
        "acquire_Postal": "300820000",
        "acquire_Country": "US",
        "acquire_PhoneNumber": "7704321202",
        "acquire_Fax": null,
        "acquire_EmailAddress": null,
        "acquire_PurchaseOrderNumber": null,
        "acquire_InvoiceNumber": null,
        "acquire_ShipmentTrackingNumber": null,
        "id": "00eb44a3-2f2d-4af3-9a68-acad001234f0",
        "externalId": null,
        "itemNumber": "00038",
        "status": 3,
        "statusText": "Disposed",
        "manufacturer": "Glock",
        "countryOfManufacture": "Austria",
        "importer": "Glock INC",
        "type": "Pistol",
        "model": "19",
        "caliber": "9X19",
        "serial": "CPY726",
        "barrelLength": null,
        "overallLength": null,
        "condition": null,
        "location": null,
        "cost": null,
        "price": 499.99,
        "mpn": "PI1950203",
        "upc": "764503502194",
        "sku": "PI1950203"
      },
      {
        "acquisitionType": "Purchase",
        "acquire_Date": "2021-01-10T20:03:06",
        "acquire_License": "158067072A90327",
        "acquire_LicenseName": "GLOCK INC",
        "acquire_LicenseExpires": "2022-01-01T00:00:00",
        "acquire_TradeName": null,
        "acquire_Organization": null,
        "acquire_FirstName": null,
        "acquire_MiddleName": null,
        "acquire_LastName": null,
        "acquire_Address1": "6000 HIGHLANDS PKWY",
        "acquire_Address2": null,
        "acquire_City": "SMYRNA",
        "acquire_State": "GA",
        "acquire_Postal": "300820000",
        "acquire_Country": "US",
        "acquire_PhoneNumber": "7704321202",
        "acquire_Fax": null,
        "acquire_EmailAddress": null,
        "acquire_PurchaseOrderNumber": null,
        "acquire_InvoiceNumber": null,
        "acquire_ShipmentTrackingNumber": null,
        "id": "01eb44a3-2f2d-4af3-9a68-acad001234f0",
        "externalId": null,
        "itemNumber": "00039",
        "status": 3,
        "statusText": "Disposed",
        "manufacturer": "Glock",
        "countryOfManufacture": "Austria",
        "importer": "Glock INC",
        "type": "Pistol",
        "model": "19 Gen 4",
        "caliber": "9X19",
        "serial": "JZP837",
        "barrelLength": null,
        "overallLength": null,
        "condition": null,
        "location": null,
        "cost": null,
        "price": 540,
        "mpn": "PG1950203",
        "upc": "764503692031",
        "sku": "PG1950203"
      },
      {
        "acquisitionType": "Purchase",
        "acquire_Date": "2021-01-10T20:03:06",
        "acquire_License": "158067072A90327",
        "acquire_LicenseName": "GLOCK INC",
        "acquire_LicenseExpires": "2022-01-01T00:00:00",
        "acquire_TradeName": null,
        "acquire_Organization": null,
        "acquire_FirstName": null,
        "acquire_MiddleName": null,
        "acquire_LastName": null,
        "acquire_Address1": "6000 HIGHLANDS PKWY",
        "acquire_Address2": null,
        "acquire_City": "SMYRNA",
        "acquire_State": "GA",
        "acquire_Postal": "300820000",
        "acquire_Country": "US",
        "acquire_PhoneNumber": "7704321202",
        "acquire_Fax": null,
        "acquire_EmailAddress": null,
        "acquire_PurchaseOrderNumber": null,
        "acquire_InvoiceNumber": null,
        "acquire_ShipmentTrackingNumber": null,
        "id": "02eb44a3-2f2d-4af3-9a68-acad001234f0",
        "externalId": null,
        "itemNumber": "00040",
        "status": 3,
        "statusText": "Disposed",
        "manufacturer": "Glock",
        "countryOfManufacture": "Austria",
        "importer": "Glock INC",
        "type": "Pistol",
        "model": "20 SF",
        "caliber": "10mm",
        "serial": "TGE329",
        "barrelLength": null,
        "overallLength": null,
        "condition": null,
        "location": null,
        "cost": null,
        "price": 545.04,
        "mpn": "PF2050203",
        "upc": "764503662034",
        "sku": "PF2050203"
      }
    ]
  }
}

Sample – disposition.items.added

{
    "id": "cb0b80e7-2061-4e22-8d32-8e1d6b9d0638",
    "eventName": "disposition.items.added",
    "accountNumber": 75001,
    "timestampUtc": "2023-04-13T21:59:20.0848182Z",
    "data": {
        "contact": null,
        "dispositionItemsAdded": [
            {
                "item": {
                    "acquisitionType": "Dealer Transfer",
                    "acquire_Date": "2018-05-03T22:47:55",
                    "acquire_License": "548055070L04391",
                    "acquire_LicenseName": "DRUSSEL, COLBY",
                    "acquire_LicenseExpires": "2020-11-01T00:00:00",
                    "acquire_TradeName": "DRUSSEL PRECISION RIFLES",
                    "acquire_Organization": null,
                    "acquire_FirstName": null,
                    "acquire_MiddleName": null,
                    "acquire_LastName": null,
                    "acquire_Address1": "9585 HANDS ROAD",
                    "acquire_Address2": null,
                    "acquire_City": "GARDEN CITY",
                    "acquire_State": "KS",
                    "acquire_Postal": "67846",
                    "acquire_Country": "US",
                    "acquire_PhoneNumber": null,
                    "acquire_Fax": null,
                    "acquire_EmailAddress": null,
                    "acquire_PurchaseOrderNumber": null,
                    "acquire_InvoiceNumber": null,
                    "acquire_ShipmentTrackingNumber": null,
                    "undeleteNote": null,
                    "locationVerifiedUtc": null,
                    "id": "73302692-51bf-446d-9fca-a8d6003ef97f",
                    "externalId": null,
                    "itemNumber": "00312",
                    "status": 2,
                    "statusText": "Pending Disposal",
                    "manufacturer": "Glock",
                    "countryOfManufacture": null,
                    "importer": "Glock Inc",
                    "type": "Pistol",
                    "model": "14",
                    "caliber": "9MM",
                    "serial": "A1300",
                    "barrelLength": null,
                    "overallLength": null,
                    "condition": null,
                    "location": null,
                    "cost": null,
                    "price": null,
                    "mpn": null,
                    "upc": null,
                    "sku": null
                },
                "id": "52532af0-da81-4e64-9c5f-afe3016a5d82",
                "price": null,
                "pawnRedemption": false
            }
        ],
        "status": 2,
        "statusText": "Awaiting Form 4473 Completion",
        "id": "17828393-0a82-49b4-a78a-afe3016a3a2a",
        "date": null,
        "type": null,
        "ttsn": null,
        "otsn": null,
        "shipmentTrackingNumber": null,
        "invoiceNumber": null,
        "purchaseOrderNumber": null,
        "theftLoss_DiscoveredDate": null,
        "theftLoss_Type": null,
        "theftLoss_ATFIssuedIncidentNumber": null,
        "theftLoss_PoliceIncidentNumber": null,
        "destroyed_Date": null,
        "destroyed_Description": null,
        "destroyed_Witness1": null,
        "destroyed_Witness2": null,
        "is4473": true,
        "isManufacturingDisposition": false
    }
}

Sample – item.edited

{
  "id": "31e3d290-40fd-49b3-910d-9af168acac50",
  "eventName": "item.edited",
  "accountNumber": 75165,
  "timestampUtc": "2021-01-11T06:25:19.9115049Z",
  "data": {
    "dispositionType": "Sale",
    "dispose_Date": "2021-01-10T20:12:36",
    "dispose_License": "158067072A90327",
    "dispose_LicenseName": "GLOCK INC",
    "dispose_LicenseExpires": "2022-01-01T00:00:00",
    "dispose_TradeName": null,
    "dispose_Organization": null,
    "dispose_FirstName": null,
    "dispose_MiddleName": null,
    "dispose_LastName": null,
    "dispose_Address1": "6000 HIGHLANDS PKWY",
    "dispose_Address2": null,
    "dispose_City": "SMYRNA",
    "dispose_State": "GA",
    "dispose_Postal": "300820000",
    "dispose_Country": "US",
    "dispose_PhoneNumber": "7704321202",
    "dispose_Fax": null,
    "dispose_EmailAddress": null,
    "ttsn": null,
    "otsn": null,
    "dispose_PurchaseOrderNumber": null,
    "dispose_InvoiceNumber": null,
    "dispose_ShipmentTrackingNumber": null,
    "submissionDate": null,
    "theftLoss_DiscoveredDate": null,
    "theftLoss_Type": null,
    "theftLoss_ATFIssuedIncidentNumber": null,
    "theftLoss_PoliceIncidentNumber": null,
    "destroyed_Date": null,
    "destroyed_Description": null,
    "destroyed_Witness1": null,
    "destroyed_Witness2": null,
    "deleteType": null,
    "deleteNote": null,
    "acquisitionType": "Purchase",
    "acquire_Date": "2021-01-10T20:03:06",
    "acquire_License": "158067072A90327",
    "acquire_LicenseName": "GLOCK INC",
    "acquire_LicenseExpires": "2022-01-01T00:00:00",
    "acquire_TradeName": null,
    "acquire_Organization": null,
    "acquire_FirstName": null,
    "acquire_MiddleName": null,
    "acquire_LastName": null,
    "acquire_Address1": "6000 HIGHLANDS PKWY",
    "acquire_Address2": null,
    "acquire_City": "SMYRNA",
    "acquire_State": "GA",
    "acquire_Postal": "300820000",
    "acquire_Country": "US",
    "acquire_PhoneNumber": "7704321202",
    "acquire_Fax": null,
    "acquire_EmailAddress": null,
    "acquire_PurchaseOrderNumber": null,
    "acquire_InvoiceNumber": null,
    "acquire_ShipmentTrackingNumber": null,
    "id": "feea44a3-2f2d-4af3-9a68-acad001234f0",
    "externalId": null,
    "itemNumber": "00036",
    "status": 3,
    "statusText": "Disposed",
    "manufacturer": "Glock",
    "countryOfManufacture": "Austria",
    "importer": "Glock INC",
    "type": "Pistol",
    "model": "17",
    "caliber": "9X19",
    "serial": "FPR266",
    "barrelLength": null,
    "overallLength": null,
    "condition": null,
    "location": null,
    "cost": null,
    "price": 499.99,
    "mpn": "PI1750203",
    "upc": "76450350210",
    "sku": "PI1750203"
  }
}