How it works
Some event(s) happens in Akeneo PIM. This triggers a mechanism to send those event(s) as HTTP POST request to your Request URL. Each request contains event, with correspondent event type presented in JSON format.
Events API sends one request per one event, and sending of requests happens in real-time.
Event types delivered over Events API
category_created (New category was created)
category_updated (Existing category was updated)
category_deleted (Existing category was deleted)
attribute_created (New attribute was created)
attribute_updated (Existing attribute was updated)
attribute_deleted (Existing attribute was deleted)
family_created (New family was created)
family_updated (Existing family was updated)
family_deleted (Existing family was deleted)
product_created (New product was created)
product_updated (Existing product was updated)
product_deleted (Existing product was deleted)
product_model_created (New product model was created)
product_model_updated (Existing product model was updated)
product_model_deleted (Existing product model was deleted)
Example of category_updated event
"en_US": "Cameras new name",
Event Type Structure
- event_type (String): Type of event which happened
- payload (Object): Contains information which represents the event
- event_time (Integer): Timestamp in seconds when the event was created
If Akeneo family contains variants, then during family update (or it's variants as well), Akeneo will re-save related products. It will trigger sending Products Update events.
- E-Mail: email@example.com
This Akeneo extension is open source, you can find the repository on GitHub
- Transport approach, to differentiate consumer which accepts events data in a specific format
- IFTTT Transport, to provide integration with IFTTT Webhooks applet
0.4.0 Initial version
Install via composer:
php composer.phar require trilix/akeneo-events-api-bundle:^0.5.0
To enable the bundle add to the app/AppKernel.php file in the registerProjectBundles() method:
protected function registerProjectBundles()
Add the following line at the end of app/config/parameters.yml:
where your_request_url is a target location where all the events will be delivered.
Add the following lines at the end of app/config/config.yml:
Run the following command to create a job to deliver events to consumer:
bin/console akeneo:batch:create-job 'Deliver outer event to consumer' deliver_outer_event_to_consumer internal deliver_outer_event_to_consumer
❗️One daemon or several daemon processes have to be started to execute the jobs. Please follow the documentation Setting up the job queue daemon if it’s not the case.