Saltar al contingut principal
POST

Crear una oportunitat

Scope:crm:deals.write
https://api.holded.com/api/v2/leads

Crea 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/json
object
idstring

Respostes d'error

400Sol·licitud incorrectaapplication/json
401API key no vàlida o no proporcionadaapplication/json
403Permisos insuficientsapplication/json
422Error de validacióapplication/json
429Límit de sol·licituds exceditapplication/json