Indicates that any of the three main listing statuses (Claim, Flow, Sync) changed. It includes information about the lifecycle of the listing and the Google status of the listing.

{
  "signature": "X",
  "event": {
    "claimStatusChanged": false,
    "googleStatusChanged": false,
    "directoryType": "ABCLOCAL",
    "flowStatusChanged": true,
    "fromListingClaimStatus": "CLAIMED_BY_US",
    "fromListingFlowStatus": "ALL_INFORMATION_SUBMITTED",
    "fromListingSyncStatus": "NOT_IN_SYNC",
    "id": 213581003,
    "listing": 332874,
    "location": 34838,
    "syncStatusChanged": true,
    "time": "2016-05-03T10:42:06.000+02:00",
    "toListingClaimStatus": "CLAIMED_BY_US",
    "toListingFlowStatus": "NO_ACTION_NEEDED",
    "toListingSyncStatus": "IN_SYNC",
    "type": "LISTING_SYNC_CHECK"
  }
}

Indicates that the status of a listing was changed manually. This happens rarely and often is the result of a manual check by our Operations or Engineering teams.

{
  "signature": "X",
  "event": {
    "claimStatusChanged": false,
    "directoryType": "ABCLOCAL",
    "flowStatusChanged": true,
    "fromListingClaimStatus": "CLAIMED_BY_US",
    "fromListingFlowStatus": "NO_ACTION_NEEDED",
    "fromListingSyncStatus": "NOT_IN_SYNC",
    "id": 213581003,
    "listing": 332874,
    "location": 34838,
    "syncStatusChanged": false,
    "time": "2016-05-03T10:42:06.000+02:00",
    "toListingClaimStatus": "CLAIMED_BY_US",
    "toListingFlowStatus": "SUBMISSION_NEEDED",
    "toListingSyncStatus": "NOT_IN_SYNC",
    "type": "LISTING_STATUS_CHANGE",
    "user": "user@example.com"

  }
}

The platform listing is now pointing to a different directory listing. This can happen either manually or automatically, by detecting a better listing on the directory side than the one previously linked.

{
    "event": {
        "business": 1234,
        "comment": "Listing link changed",
        "fromListingId": "456",
        "fromListingUrl": "http://old-listing.url/456",
        "id": 5549734563,
        "listing": 2345,
        "location": 3456,
        "time": "2019-11-18T14:12:36.000+01:00",
        "toListingId": "789",
        "toListingUrl": "http://new-listing.url/789",
        "type": "LISTING_LINK_CHANGE"
    },
    "signature": "X"
}

Indicates that while doing a check for listing datapoints (i.e. customer feedback such as reviews, photos, etc.), we found new ones.

{
  "event": {
    "business": 1420951,
    "directoryType": "JUDYS_BOOK"
    "id": 213580990,
    "listing": 332874,
    "location": 34838,
    "newCheckinsFound": 1,
    "newCommentsFound": 1,
    "newConversationsFound": 1,
    "newDatapointsFound": true,
    "newPhotosFound": 1,
    "newQuestionsFound": 1,
    "newReviewsFound": 1,
    "newDataPointIds": [
      250976288,
      250976289
    ],
    "time": "2016-05-03T10:19:14.000+02:00",
    "type": "LISTING_DATAPOINT_CHECK"
  },
  "signature": "X"
}

Indicates that a listing's datapoint has been deleted or invalidated on the directory, so we invalidate it on our side. You can delete or invalidate them on your side too. It's unlikely that a datapoint will be reinstated by the directory.

{
  "event": {
    "business": 1107630,
    "deletedDataPointIds": [],
    "directoryType": "YELP_API",
    "id": "99",
    "invalidDataPointIds": [
      434424555
    ],
    "listing": 119934719,
    "location": 4154762,
    "time": "2023-12-20T19:00:34.508+01:00",
    "type": "LISTING_DATAPOINT_INVALID"
  },
  "signature": "YIfeSTln/p2JaPTY3WhVSsFRvy3NgtRhCFzGI/Fc+60="
}

Indicates that a new brand data point has been found, e.g. review on a Facebook brand page

{
  "event": {
    "business": 244397,
    "directoryBusinessPage": 1220,
    "directoryType": "FACEBOOK",
    "id": 4,
    "newDataPointIds": [
      289,
      299
    ],
    "newDatapointsFound": true,
    "time": "2023-12-21T12:03:31.358+01:00",
    "type": "DIRECTORY_BUSINESS_PAGE_DATA_POINT_CHECK",
    "updatedDataPointIds": [
      79,
      253
    ]
  },
  "signature": "9kTmfuFg9T5LDD59ZodiyOFtoLSItG737ZRL2fBD7O4="
}

Indicates that a brand's datapoint has been deleted or invalidated on the directory, so we invalidate it on our side. You can delete or invalidate them on your side too. It's unlikely that a datapoint will be reinstated by the directory.

{
  "event": {
    "business": 909288,
    "deletedDataPointIds": [],
    "directoryBusinessPage": 173,
    "directoryType": "FACEBOOK",
    "id": 7,
    "invalidDataPointIds": [
      4737279
    ],
    "time": "2024-01-02T17:17:49.664+01:00",
    "type": "DIRECTORY_BUSINESS_PAGE_DATA_POINT_INVALID"
  },
  "signature": "/GHkwuBIxYadsaWPq1V8vztXVuSlf1txDSxZuBAH1UQ="
}

Indicates that we tried to submit the listing to the directory.

{
 "event": {
 "business": 7141,
 "directoryType": "BING",
 "id": 17518447719,
 "listing": 7198166,
 "location": 450978,
 "messages": [
 "Listing was updated successfully!"
 ],
 "time": "2021-10-27T16:21:14.000+02:00",
 "type": "LISTING_UPDATE",
 "updateResult": "SUCCESS",
 "updateStatus": null
 },
 "signature": "X"
}

        MANDATORY_FIELD_MISSING, // one or more fields are mandatory, but are not set in the location
        NOT_SUPPORTED, // the listing is not supported on that directory (e.g. INSTAGRAM -> we only have listing URLs without any direct submission)
        INVALID_CLAIM_STATUS, // claim status is invalid (e.g. CLAIMED_BY_OTHERS, but we can only update CLAIMED_BY_US)
        INVALID_FLOW_STATUS, // flow status is invalid (e.g. NEEDS_REVIEW)
        INVALID_SYNC_STATUS, // sync status is invalid (e.g we cannot update listing that have TECHNICAL_PROBLEMS)
        INVALID_LOCATION_STATUS, // location status is invalid (e.g. NEEDS_REVIEW)
        LOCATION_NOT_NORMALIZED, // location is not normalized
        DUPLICATED, // listing is duplicated, we should not display the logging event as a failure, as there's been no error. see CylexUpdateService#update
        LIMIT_REACHED, // can be used when the update fails for throttling or for limits set by the directory
        ADDRESS_DISPLAY_NOT_SUPPORTED, // directory doesn't support address display
        LOCATION_NOT_SYNCED, // the location of the listing has not been synced yet
        LOCATION_NOT_CLEANSED, // the location has not been cleansed yet so we shouldn't push data to some directories that require cleansing-only
        DELAYED, // the sync was delayed to a later point in time because of directory restrictions

Indicates that a new location has been created in your account.

{
  "event": {
    "comment": "A new Location has been created",
    "id": 2926113683,
    "location": 636605,
    "time": "2018-11-05T17:35:07.000+01:00",
    "type": "LOCATION_CREATED",
    "source": "API"
  },
  "signature": "X"
}

Indicates that the status of a location changed.

{
  "event": {
    "comment": "Checked and activated by a human being.",
    "from": "ACTIVE",
    "id": 213580999,
    "location": 34838,
    "time": "2016-05-03T10:34:43.000+02:00",
    "to": "CANCELLED",
    "type": "LOCATION_STATUS_CHANGED",
    "user": "user@example.com"
  },
  "signature": "X"
}

Indicates that a user changed data of a location.

{
  "event": {
    "comment": "Location profile has been updated",
    "id": 2926113683,
    "location": 636605,
    "time": "2018-11-05T17:35:07.000+01:00",
    "type": "LOCATION_PROFILE_CHANGED",
    "user": "user@example.com"
  },
  "signature": "X"
}

Indicates that a user and API update or our system has changed the ProductPlan of a Business and its assigned Locations

{
    "event": {
        "business": 1,
        "comment": "Business product plan has been changed",
        "id": 5136210330,
        "salesPartnerIdentifier": "identifier",
        "newProductPlanId": 2,
        "newProductPlanName": "My Product Plan 2",
        "newProductPlanPrice": 20,
        "oldProductPlanId": 1,
        "oldProductPlanName": "My Product Plan 1",
        "oldProductPlanPrice": 10,
        "time": "2019-10-09T15:10:01.000+02:00",
        "type": "BUSINESS_PRODUCT_PLAN_CHANGED",
        "changedBy": "user@example.com"
    },
    "signature": "XYZ"
}

Indicates that a new Business has been created in the partner account

{
    "event": {
        "business": 631498,
        "changedBy": "PRIVATE_TOKEN",
        "comment": "New business has been created",
        "id": 5385813249,
        "salesPartnerIdentifier": "identifier",
        "time": "2019-11-07T16:30:19.000+01:00",
        "type": "BUSINESS_CREATED"
    },
    "signature": "X”
}