.. _webhooks_alpha: Alpha: Webhooks ================ Current version: 0.1 (alpha) Warning: This is alpha functionality and may change or break without notice. If your integration stops working or you encounter issues, please contact Recras Support so we can help resolve it and keep you informed about changes. Webhooks let your system react to changes in Recras in near real time. Standard ORM lifecycle events are emitted for many internal objects; we also provide a few custom events for common business actions. Event semantics ---------------- - postInsert: fired after a new record is created. - postUpdate: fired after an existing record is updated. - postDelete: fired after an existing record is deleted. - postSave: always fired together with postInsert or postUpdate. In other words: saving a model triggers postInsert/postUpdate and postSave. Payload wrapper ---------------- Every webhook payload is wrapped in a small envelope with a version, the actual data, and a meta object (reserved for transport/context). The version only increases when the payload contract changes. .. code-block:: json { "version": "0.1", "data": { /* event-specific fields */ }, "meta": { /* transport or context fields */ } } Custom Events ------------- Custom events do not contain '::' in their name. .. toctree:: :maxdepth: 1 bookingdefinitive invoicedefinitive ORM Events ---------------- These events map to ORM lifecycle events and contain '::' in their name. .. toctree:: :maxdepth: 1 activiteit_postdelete activiteit_postinsert activiteit_postsave activiteit_postupdate apikey_postdelete apikey_postinsert apikey_postsave apikey_postupdate arrangement_postdelete arrangement_postinsert arrangement_postsave arrangement_postupdate attachment_postdelete attachment_postinsert attachment_postsave attachment_postupdate bedrijf_postdelete bedrijf_postinsert bedrijf_postsave bedrijf_postupdate betaalmethode_postdelete betaalmethode_postinsert betaalmethode_postsave betaalmethode_postupdate boeking_postdelete boeking_postinsert boeking_postsave boeking_postupdate boekingsmail_postdelete boekingsmail_postinsert boekingsmail_postsave boekingsmail_postupdate boekingsmailzending_postdelete boekingsmailzending_postinsert boekingsmailzending_postsave boekingsmailzending_postupdate boekingsvoorstel_postdelete boekingsvoorstel_postinsert boekingsvoorstel_postsave boekingsvoorstel_postupdate boekingsvoorsteltype_postdelete boekingsvoorsteltype_postinsert boekingsvoorsteltype_postsave boekingsvoorsteltype_postupdate bookprocess_postdelete bookprocess_postinsert bookprocess_postsave bookprocess_postupdate contact_postdelete contact_postinsert contact_postsave contact_postupdate contactformulier_postdelete contactformulier_postinsert contactformulier_postsave contactformulier_postupdate contactmoment_postdelete contactmoment_postinsert contactmoment_postsave contactmoment_postupdate contactpersoon_postdelete contactpersoon_postinsert contactpersoon_postsave contactpersoon_postupdate dienst_postdelete dienst_postinsert dienst_postsave dienst_postupdate factuur_postdelete factuur_postinsert factuur_postsave factuur_postupdate factuurbetaling_postdelete factuurbetaling_postinsert factuurbetaling_postsave factuurbetaling_postupdate incomingmail_postdelete incomingmail_postinsert incomingmail_postsave incomingmail_postupdate incomingmailaddress_postdelete incomingmailaddress_postinsert incomingmailaddress_postsave incomingmailaddress_postupdate integration_postdelete integration_postinsert integration_postsave integration_postupdate kassa_postdelete kassa_postinsert kassa_postsave kassa_postupdate kassalogboek_postdelete kassalogboek_postinsert kassalogboek_postsave kassalogboek_postupdate klant_postdelete klant_postinsert klant_postsave klant_postupdate kortingscode_postdelete kortingscode_postinsert kortingscode_postsave kortingscode_postupdate kwalificatie_postdelete kwalificatie_postinsert kwalificatie_postsave kwalificatie_postupdate leveranciercontact_postdelete leveranciercontact_postinsert leveranciercontact_postsave leveranciercontact_postupdate locatie_postdelete locatie_postinsert locatie_postsave locatie_postupdate materiaal_postdelete materiaal_postinsert materiaal_postsave materiaal_postupdate overigcontact_postdelete overigcontact_postinsert overigcontact_postsave overigcontact_postupdate pdftemplate_postdelete pdftemplate_postinsert pdftemplate_postsave pdftemplate_postupdate personeelbeschikbaarheid_postdelete personeelbeschikbaarheid_postinsert personeelbeschikbaarheid_postsave personeelbeschikbaarheid_postupdate personeelcontact_postdelete personeelcontact_postinsert personeelcontact_postsave personeelcontact_postupdate productgroep_postdelete productgroep_postinsert productgroep_postsave productgroep_postupdate queuedmail_postdelete queuedmail_postinsert queuedmail_postsave queuedmail_postupdate sfguardgroup_postdelete sfguardgroup_postinsert sfguardgroup_postsave sfguardgroup_postupdate sfguarduser_postdelete sfguarduser_postinsert sfguarduser_postsave sfguarduser_postupdate standaardbijlage_postdelete standaardbijlage_postinsert standaardbijlage_postsave standaardbijlage_postupdate startmoment_postdelete startmoment_postinsert startmoment_postsave startmoment_postupdate startmomentgroep_postdelete startmomentgroep_postinsert startmomentgroep_postsave startmomentgroep_postupdate statusherinnering_postdelete statusherinnering_postinsert statusherinnering_postsave statusherinnering_postupdate urenregistratie_postdelete urenregistratie_postinsert urenregistratie_postsave urenregistratie_postupdate voucher_postdelete voucher_postinsert voucher_postsave voucher_postupdate vouchertemplate_postdelete vouchertemplate_postinsert vouchertemplate_postsave vouchertemplate_postupdate webhook_postdelete webhook_postinsert webhook_postsave webhook_postupdate