Saltar al contingut principal
GET

Obtenir un embut per ID

Scope:crm:funnels.read
https://api.holded.com/api/v2/funnels/{funnelId}

Recupera els detalls d'un embut específic pel seu identificador únic.

Paràmetres

Paràmetres de ruta

funnelIdstringobligatori

ID de l'embut (ObjectId hexadecimal de 24 caràcters)

Petició

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())

Respostes

Resposta

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"
}

Respostes exitoses

200Embut trobatapplication/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

Respostes d'error

401API key no vàlida o no proporcionadaapplication/json
403Permisos insuficientsapplication/json
404Embut no trobatapplication/json
429Límit de sol·licituds exceditapplication/json