Saltar al contenido principal
GET

Abrir o ver un embudo

Scope:crm:funnels.read
https://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

funnelIdstringobligatorio

ID 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/json
object
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/json
403Permisos insuficientesapplication/json
404Embudo no encontradoapplication/json
429Límite de solicitudes excedidoapplication/json