> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yampi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Opportunity

> Crea una nueva oportunidad en el pipeline.

Crea una oportunidad asociada a la cuenta. El cuerpo debe cumplir con el esquema `opportunity` del OpenAPI (título, estado, valor, contacto, etc.).

## Autenticación

<ParamField header="api_access_token" type="string" required>
  Token de usuario (**userApiKey**).
</ParamField>

## Parámetros de ruta

<ParamField path="account_id" type="integer" required>
  ID de la cuenta.
</ParamField>

## Cuerpo de la solicitud

Envía un objeto con los campos de la oportunidad (por ejemplo `title`, `status`, `value`, `contact_id`, `pipeline_id`). Consulta el OpenAPI para el esquema exacto.

## Ejemplo de solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://app.yampi.ai/api/v1/accounts/1/opportunities' \
    -H 'api_access_token: TU_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{"title": "Venta apartamento 101", "status": "open", "value": 250000000}'
  ```
</RequestExample>

## Respuesta exitosa

Devuelve la oportunidad creada con `id` y el resto de campos según el esquema.

## Errores

* **401**: No autenticado.
* **422**: Unprocessable Entity — datos inválidos.