Photo-Motion API

Appearance

Notifications ​

Our system features a powerful notification feature that allows us to send notifications to one or more of your endpoints when new content is available. This functionality is essential for integrating with other systems that need to be notified of updates immediately, ensuring smooth and efficient communication between the various components of your workflow.

Simulate notifications ​

In Photo-Motion Online, you can manually send a notification to run tests. See the explanation for each notification below.

Webhooks ​

We use webhooks for our notification feature. A webhook is a way for one system to automatically send a message to another system when a specific event happens in real time rather than the other system having to continuously check (“poll”) for updates.

When the event you care about occurs (e.g. advert.completed, spinner.completed), our server makes an HTTP POST request to a URL you’ve configured. That payload typically contains JSON with details about the event, which your system can then use to trigger whatever action you want.

Developing a webhook ​

To speed up webhook development for you, we recommend https://webhook.site. Send us the unique URL, and we'll set up the desired notification(s) for you. We can easily change the URL to your actual endpoint later.

Condition: When an advert is created or updated
Event type: advert.completed

Request example
json
{
  "data": {
    "id": 2204964,
    "name": "Advert",
    "type": "advert",
    "image": "https://cdn.photo-motion.com/images/mklQfhSsNJ4zpHAC/017f9ea9-e3dc-4bd9-8b54-65591bf0a8b5/409cfcc3-872d-4d79-bbb3-3cffc9799235",
    "event": {
      "type": "advert.completed"
    }
  },
  "links": {
    "self": "https://online.photo-motion.com/v2/client/1/product/596308/album/2204964"
  },
  "related": {
    "product": {
      "data": {
        "id": 596308,
        "name": "Name of the vehicle",
        "vin": "WVGZZZ1T5RW011446"
      },
      "links": {
        "self": "https://online.photo-motion.com/v2/client/149/product/596308"
      }
    },
    "client": {
      "data": {
        "id": 1,
        "name": "Photo-Motion"
      },
      "links": {
        "self": "https://online.photo-motion.com/v2/client/1"
      }
    },
    "offices": [
      {
        "data": {
          "id": 1261,
          "name": "Eindhoven"
        },
        "links": {
          "self": "https://online.photo-motion.com/v2/client/1/office/1261"
        }
      }
    ]
  }
}
Simulate notification

  1. Select the desired advertising folder
    select-advert

  2. Send notification
    send-notification-advert

Spinner Completed ​

Condition: When an spinner is created or updated
Event type: spinner.completed

Request example
json
{
  "data": {
    "id": 567415,
    "name": "GPF95X spinner",
    "hash": "c6bef279-b2da-4f73-b4ab-4ec251605c48",
    "image": "https://cdn.photo-motion.com/images/aJ9PU_c7PdsLCjm2/8101482e-2291-4afd-bb90-e6d477f572a0/684e4bf6-2465-43cb-b01e-35120bbc5f53",
    "image_id": 90261645,
    "created_at": "2025-04-15T05:33:27.000000Z",
    "updated_at": "2025-04-15T05:33:33.000000Z",
    "event": {
      "type": "spinner.completed"
    }
  },
  "links": {
    "self": "https://online.photo-motion.com/v2/client/1/product/620840/spinner/567415",
    "related": {
      "href": "https://spinner.photo-motion.com/c6bef279-b2da-4f73-b4ab-4ec251605c48", 
      "title": "GPF95X spinner"
    }
  },
  "related": {
    "product": {
      "data": {
        "id": 596308,
        "name": "Name of the vehicle",
        "vin": "WVGZZZ1T5RW011446"
      },
      "links": {
        "self": "https://online.photo-motion.com/v2/client/149/product/596308"
      }
    },
    "client": {
      "data": {
        "id": 1,
        "name": "Photo-Motion"
      },
      "links": {
        "self": "https://online.photo-motion.com/v2/client/1"
      }
    },
    "offices": [
      {
        "data": {
          "id": 1261,
          "name": "Eindhoven"
        },
        "links": {
          "self": "https://online.photo-motion.com/v2/client/1/office/1261"
        }
      }
    ]
  }
}
Simulate notification

create-spinner