Saltar al contenido principal
POST

Enviar presupuesto por email

Scope:sales:estimates.write
https://api.holded.com/api/v2/estimates/{estimateId}/send

Envía el presupuesto por email al contacto con un asunto y un mensaje propios opcionales; sin ellos, se usa la plantilla configurada. Si no se indican `emails`, se envía a las direcciones del contacto del documento, como las rellena el diálogo de envío de la app; si el contacto no tiene ninguna, la petición se rechaza.

Parámetros

Parámetros de ruta

estimateIdstringobligatorio

ID del presupuesto (ObjectId hexadecimal de 24 caracteres)

Cuerpo de la petición

object
emails[]string[] | null

Lista de direcciones de email destinatarias. Si se omite, se envía a las direcciones del contacto del documento; una lista vacía se rechaza.

subjectstring | null

Asunto personalizado del email

messagestring | null

Cuerpo personalizado del email

mail_template_idstring | null

Identificador de la plantilla de email a usar

cc[]string[] | null

Lista de direcciones de email en copia (CC)

bcc[]string[] | null

Lista de direcciones de email en copia oculta (CCO)

Petición

python
import requests

url = "https://api.holded.com/api/v2/estimates/{estimateId}/send"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "emails": [
        "string"
    ],
    "subject": "string",
    "message": "string",
    "mail_template_id": "string",
    "cc": [
        "string"
    ],
    "bcc": [
        "string"
    ]
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

Respuestas

Respuestas exitosas

200Presupuesto enviado

Respuestas de error

400Solicitud incorrectaapplication/json
401API key inválida o no proporcionadaapplication/json
403Permisos insuficientesapplication/json
404Presupuesto no encontradoapplication/json
429Límite de solicitudes excedidoapplication/json