Version history for the Immofacile API V2. Changes follow semantic versioning and the Keep a Changelog format (Added, Changed, Deprecated, Removed, Fixed, Security).
This version number tracks the evolution of the API contract and is independent of the /v2/ URL prefix, which is a stable interface level and does not change with these releases.
Added
New outbound calendar webhook event. Immofacile now sends an HTTP
POSTto your registered URL when a subscribed calendar event occurs (CALENDAR_CREATE,CALENDAR_UPDATE,CALENDAR_DELETE). Requires theMODULE_IMMO_AGENDAmodule.The contact search endpoint
POST /customers/searchnow accepts theincludequery parameter (comma-separated) to load additional relations on each returned contact, consistent withGET /customers/{customerId}. Available includes:address,groups,color,origin,user,gender,stopSms,notary,relations,subscriptions,searchRequests,agency,consent,mandate,website. An unknown include returns a validation error listing the available includes.New endpoints added to the documentation:
GET /actions/{actionId}— logged actions of a given action type, optionally for one customer or product.
Webhook documentation completed: the
CUSTOMER_CREATE,CUSTOMER_UPDATE,PRODUCT_CREATE,PRODUCT_UPDATEandCALENDAR_*events are documented, with theorigineenum onPOST /hooksandPUT /hooks/{hookId}.
Changed
- Webhook payload documentation corrected to match what is actually sent:
{timestamp, origine, client_id, site_ids, data}instead of{event_type, resource_id, timestamp}. - Webhook delivery rules clarified: 4xx responses (including
422) are not retried, only 5xx, timeouts and network errors are (up to 3 times); the response timeout is 60 seconds; theformatfield acceptsimmofacile(default) orzapier. - Calendar event
typeis now documented as the event type identifier (e.g."7") rather than the event type key (e.g.VISIT), to match the actual payload returned by the agenda endpoints.