---
title: "Crea una tarea"
method: POST
path: "/api/v1/tareas"
tags: ["Tareas"]
---

# Crea una tarea

`POST /api/v1/tareas`

## Request

- Base URL: `https://api.mobiliagestion.es` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mobiliagestion.es/api/v1/tareas`
- Auth: API key in header `Authorization`

Crea una tarea en la agencia con la información enviada y devuelve su información.



**Requisitos:**
- `tareas_create`

## Request body

- TareaCrearRequest
  - `idAgente` integer: Id del agente
  - `referenciaCliente` integer, nullable: Referencia del cliente a vincular
  - `referenciaInmueble` string, nullable: Referencia del inmueble a vincular
  - `referenciaSolicitud` integer, nullable: Referencia de la solicitud a vincular
  - `referenciaDemanda` integer, nullable: Referencia de la demanda a vincular
  - `referenciaOperacion` integer, nullable: Referencia de la operacion a vincular
  - `estado` 'Pendiente' | 'Finalizado' | 'Cancelado' | 'Aplazado' | 'Archivado'
  - `idTipo` integer: Id del tipo de tarea
  - `asunto` string, nullable: Asunto de la tarea
  - `comentarios` string, nullable: Comentarios de la tarea
  - `fechaInicio` string, date-time: Fecha de inicio de la tarea (YYYY-MM-DD HH:MM:SS)
  - `fechaFin` string, date-time, nullable: Fecha de fin de la tarea (YYYY-MM-DD HH:MM:SS)
  - `sincronizar` boolean, nullable: Sincronizar la tarea con Google Calendar. Es necesario haber configurado la sincronización con Google Calendar desde Mobilia. Por defecto False

## Response `200`

OK

- TareaResponseApiResponse
  - `datos` TareaResponse
    - `idTarea` integer
    - `idAgente` integer, nullable
    - `referenciaCliente` integer, nullable
    - `referenciaInmueble` string, nullable
    - `referenciaPersonalizadaInmueble` string, nullable
    - `referenciaSolicitud` integer, nullable
    - `referenciaDemanda` integer, nullable
    - `referenciaOperacion` integer, nullable
    - `estado` string, nullable
    - `idEstadoTarea` integer, nullable
    - `idTipo` integer, nullable
    - `asunto` string, nullable
    - `sincronizar` boolean, nullable
    - `comentarios` string, nullable
    - `fechaInicio` string, date-time, nullable
    - `fechaFin` string, date-time, nullable

## Changes

- **2026-11-06** `d893803b00d5`: 1 info
  - added the optional property `datos/referenciaPersonalizadaInmueble` to the response with the `200` status

[Operation history](https://skmtc.dev/mobiliagestion/apis/mobilia-public-api/changes/api/v1/tareas/post.md)

---

[API](https://skmtc.dev/mobiliagestion/apis/mobilia-public-api.md) - [All operations](https://skmtc.dev/mobiliagestion/apis/mobilia-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mobiliagestion/apis/mobilia-public-api/revisions/d893803b00d5?raw)