GET
Abrir o ver un embudo
Scope:
crm:funnels.readhttps://api.holded.com/api/v2/funnels/{funnelId}Recupera los detalles de un embudo específico por su identificador único.
Parámetros
Parámetros de ruta
funnelId
stringobligatorioID del embudo (ObjectId hexadecimal de 24 caracteres)
Petición
python
import requests
url = "https://api.holded.com/api/v2/funnels/{funnelId}"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.json())Respuestas
Respuesta
json
{
"id": "507f1f77bcf86cd799439011",
"name": "string",
"stages": [
{
"id": "507f1f77bcf86cd799439011",
"name": "string",
"key": "string",
"description": "string",
"deal_probability": 0,
"rotting_days": 0
}
],
"labels": [
{}
],
"created_at": "string",
"updated_at": "string"
}Respuestas exitosas
200Embudo encontradoapplication/jsonobject
idstringrequired
Unique identifier
namestringrequired
Funnel name
stages[]object[]required
Funnel stages
idstring
namestring
keystring
descriptionstring
deal_probabilityinteger
rotting_daysinteger
labels[]object[]required
Funnel labels
created_atstring | nullrequired
Creation date in ISO 8601 format
updated_atstring | nullrequired
Last update date in ISO 8601 format
Respuestas de error
401API key inválida o no proporcionadaapplication/json403Permisos insuficientesapplication/json404Embudo no encontradoapplication/json429Límite de solicitudes excedidoapplication/json