Create an action for a customer

Request

Logs a new commercial action on a customer record. Requires SITE_CUSTOMER:WRITE permission.

Important: The action is always recorded in the application journal. However, it will only appear in the customer's action history tab if the action type has child actions configured for the site. This depends on the agency's action workflow configuration.

Use GET /actions/types to list available action types and check which ones have child actions configured.

Security

bearerAuth

Path

customerIdintegerrequired

ID of the customer.

Example:789

Bodyapplication/jsonrequired

action_idintegerrequired

Action type ID. Must be active for the site. Use GET /actions/types to discover available action types.

Example:15

user_idinteger or null

User (agent) ID who performed the action. When omitted, no user is associated with the action.

Example:456

resultstring or null

Action result/comment (free text).

Example:"Client intéressé, rappeler la semaine prochaine"

date_performedstring or null, (date-time)

Date when the action was performed. ISO 8601 format. When omitted, defaults to now.

Example:"2026-01-15T14:30:00+01:00"

curl -i -X POST \
  https://api-doc.immo-facile.com/_mock/openapi/customers/789/actions \
  -H 'Authorization: Bearer <YOUR_opaque_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "action_id": 15,
    "user_id": 456,
    "result": "Client intéressé, rappeler la semaine prochaine",
    "date_performed": "2026-01-15T14:30:00+01:00"
  }'

Responses

Action created

Bodyapplication/json

dataobject

Response

{
  "data": {
    "id": 98765
  }
}