Aggiungere una trattativa a una pipeline HubSpot è un POST su /hubspot/v1/connections/{connection_id}/projects/{project_id}/tasks, nella Top-Rated Team HubSpot API: gli account HubSpot che la tua organizzazione ha collegato, e le pipeline che raggiungono. Ogni richiesta porta la tua chiave in un header X-API-KEY — la stessa chiave dell’API di LinkedIn — e raggiunge solo quelle connessioni.
Le chiamate partono con il token dell’app privata incollato da un membro, quindi HubSpot registra tutto come quell’app — ed è la stessa connessione con cui una stanza di progetto tiene allineate le sue trattative.
La richiesta
curl -X POST "https://top-rated.team/hubspot/v1/connections/$CONNECTION_ID/projects/$PROJECT_ID/tasks" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
Cosa va nel percorso
- connection_id — un id restituito da una chiamata precedente di questa famiglia.
- project_id — un id restituito da una chiamata precedente di questa famiglia.
Cosa torna quando non funziona
- 401 — la chiave manca, è sbagliata o è stata revocata.
- 402 — il piano non è pagato. La Top-Rated Team API risponde così quando la prova è finita.
- 404 — o la cosa non c’è, o non è della tua organizzazione. Le due risposte sono uguali di proposito, così gli id non si possono sondare.
- 429 — troppe richieste, o la piattaforma che ci chiede di rallentare. Aspetta un momento prima di riprovare.
- 502 o 503 — la piattaforma non ha risposto proprio ora. Riprova tra un momento.
Ogni errore è JSON nella stessa forma: {"type":"errors/<code>","status":<n>,"detail":"..."} — così un solo gestore li copre tutti, e il detail è scritto per essere mostrato a una persona.
Chiederlo a un assistente
Questa operazione è anche uno strumento MCP. Incolla https://top-rated.team/hubspot/mcp/<your API key> in Claude, ChatGPT o qualunque assistente che parli MCP e chiedi quello che vuoi in italiano — l’assistente sceglie la chiamata, riempie gli id e ti legge la risposta. Anche l’agente tutto in uno di https://top-rated.team/mcp/<your API key> ce l’ha, insieme all’API di LinkedIn e a tutti gli altri canali.
In una stanza di progetto
In una stanza di progetto, spunta l’agente di questa API sotto Può usare per un tuo agente IA, e questo chiama «Aggiungere una trattativa a una pipeline HubSpot» come strumento ogni volta che la conversazione ne ha bisogno. Tutti nella stanza vedono cosa ha chiesto e cosa è tornato. Chiedi a parole tue; qui l’agente si chiama @scout:
- @scout cosa si è mosso questa settimana nella nostra pipeline HubSpot, e cosa è rimasto fermo?
Domande frequenti
Un agente IA può chiamare «Aggiungere una trattativa a una pipeline HubSpot» per me?
Sì. Può farlo qualsiasi assistente che parli MCP, tramite l’indirizzo qui sopra, e così un tuo agente IA in una stanza di progetto con l’agente di questa API spuntato. Gli agenti integrati di una stanza no: consigliano, e non hanno la tua chiave.
Funziona fuori da una stanza, dal mio codice?
Sì. La richiesta qui sopra è la stessa operazione che chiama lo strumento di un agente IA, con la stessa risposta e gli stessi errori, e la tua chiave raggiunge gli stessi canali, in qualunque modo tu entri.
Funziona in una stanza con il mio marchio?
Sì. Su un indirizzo White Label l’API, il suo riferimento e il suo agente IA portano il nome del tuo prodotto, e raggiungono gli stessi canali con le stesse regole.
Una persona può approvare prima che un agente IA lo faccia?
Scrivilo nelle istruzioni dell’agente IA: dire cosa sta per inviare e aspettare che una persona nella stanza dica «via». Una stanza mostra ogni risposta a tutti quelli che ci sono, quindi le parole si vedono prima che raggiungano qualcuno all’esterno.
In quale piano
Fa parte del piano Top-Rated Team API, con la stessa chiave dell’API di LinkedIn: 9 $ per postazione al mese, 7 $ da cento postazioni. Ti servono tante postazioni quante ne hai del tipo più numeroso — account LinkedIn, numeri WhatsApp, account X o account della casella di posta — e la prova di 30 giorni ne copre una.