POST
Crear una oportunitat
Scope:
crm:deals.writehttps://api.holded.com/api/v2/leadsCrea una nova oportunitat CRM en el teu compte.
Cos de la petició
object
funnel_idstringrequired
Identificador de l'embut
contact_idstringrequired
Identificador del contacte associat
namestringrequired
Nom de l'oportunitat
stage_idstring | nulloptional
Identificador de l'etapa de l'embut
valuenumber | nulloptional
Valor econòmic estimat de l'oportunitat
potentialnumber | nulloptional
Probabilitat de tancament en percentatge
due_datestring<date> | nulloptional
Data límit en format ISO 8601
assigned_tostring | nulloptional
Identificador de l'usuari assignat
custom_fields[]object[] | nulloptional
Valors de camps personalitzats
Petició
python
import requests
url = "https://api.holded.com/api/v2/leads"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
payload = {
"funnel_id": "string",
"contact_id": "string",
"name": "string",
"stage_id": "string",
"value": 0,
"potential": 0,
"due_date": "2024-01-15",
"assigned_to": "string",
"custom_fields": [
{}
]
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())Respostes
Resposta
json
{
"id": "507f1f77bcf86cd799439011"
}Respostes exitoses
201Oportunitat creadaapplication/jsonobject
idstring
Respostes d'error
400Sol·licitud incorrectaapplication/json401API key no vàlida o no proporcionadaapplication/json403Permisos insuficientsapplication/json422Error de validacióapplication/json429Límit de sol·licituds exceditapplication/json