Data Sources API pentru Data Studio

Ce este?

Un API public care le permite dezvoltatorilor să creeze, să gestioneze și să introducă date în HubSpot Data Studio în mod programatic — fără a fi necesară utilizarea interfeței. Sunt acceptate două tipuri de surse de date:

• • - FILE — încarcă un fișier CSV, XLS, XLSX sau TSV pentru a crea o sursă de date
  • - JSON — definește o schemă și trimite date structurate direct prin API, cu un endpoint incremental data-push pentru actualizări continue

  Toate operațiunile sunt accesibile prin OAuth standard.

Link către documentația API aici: https://developers.hubspot.com/docs/api-reference/2026-09-beta/data-studio/datasource-ingestion/guide

API-ul complet:

• POST /data-source — creează o sursă de date FILE (CSV/XLS/XLSX/TSV)
• GET — preia o sursă de date
• PUT — înlocuiește complet o sursă de date
• DELETE — șterge o sursă de date
• POST /data-source — creează o sursă de date JSON
• POST /{id}/data-push — trimite rânduri către o sursă de date JSON
• PATCH — redenumește o sursă de date

De ce este important?

Acest API oferă o modalitate mai flexibilă și mai accesibilă pentru dezvoltatori de a introduce date tabelare în Data Studio din HubSpot, fără a fi necesară utilizarea obiectelor CRM.

CRM Imports API are cerințe stricte: datele trebuie mapate la obiecte CRM și nu există o modalitate de actualizare incrementală. Dezvoltatorii care vor să trimită date brute sau personalizate — nu înregistrări CRM — nu au o opțiune simplă.

Data Source Ingestion API este independent de schemă. Datele nu trebuie să fie mapate la niciun tip de obiect HubSpot. Dezvoltatorii definesc schema, introduc datele prin încărcarea unui fișier sau prin JSON, iar acestea ajung în Data Studio, unde sunt disponibile imediat pentru datasets, rapoarte și activare în segmente, workflow-uri și liste.

Endpoint-ul data-push permite introducerea simplă și continuă a datelor pentru actualizări recurente, precum fluxuri de date pentru enrichment de la parteneri, snapshot-uri operaționale sau rezultate generate de agenți, fără a fi necesară gestionarea încărcărilor de fișiere de fiecare dată.

Cum funcționează?

Crearea unei surse de date FILE

Încarcă un fișier CSV, XLS, XLSX sau TSV printr-un request POST multipart, împreună cu definiția schemei — numele și tipurile coloanelor. Ingestia este asincronă — verifică prin GET până când lastIngestionStatus: SUCCESSFUL este returnat. Folosește PUT pentru a înlocui întregul set de date cu un fișier nou.

POST /data-studio/data-source/2026-09-betaContent-Type: multipart/form-data  file: sample-data.csv request: {   "datasourceName": "Sample Data",   "datasourceType": "FILE",   "config": {     "file": {       "headerRowIndex": 1,       "columns": [         { "name": "email", "type": "STRING" },         { "name": "revenue", "type": "DECIMAL" }       ]     }   } } 

Crearea unei surse de date JSON

Definește schema — numele și tipurile coloanelor — în corpul request-ului, fără a fi necesar un fișier. Opțional, poți include rândurile inițiale în momentul creării sau poți crea doar schema și trimite datele ulterior. Opțional, poți seta un câmp recordId pentru deduplicare. Ingestia este asincronă — verifică prin GET până când lastIngestionStatus: SUCCESSFUL este returnat înainte de a trimite mai multe date.

POST /data-studio/data-source/2026-09-beta {   "datasourceName": "Customer Snapshot",   "datasourceType": "JSON",   "config": {     "json": {       "columns": [         { "name": "email", "type": "STRING" },         { "name": "customer_id", "type": "INTEGER" },         { "name": "spend", "type": "DECIMAL" }       ],       "recordId": "customer_id"     }   } } 

Trimiterea incrementală a rândurilor — doar pentru JSON

După activarea unei surse de date JSON, poți trimite rânduri noi fără a înlocui întregul set de date:

POST /data-studio/data-source/2026-09-beta/{datasourceId}/data-push {   "data": [     { "email": "alice@example.com", "customer_id": 1, "spend": 450.00 },     { "email": "bob@example.com", "customer_id": 2, "spend": 125.00 }   ] } 

Cine beneficiază?

Smart CRM Professional, Data Hub Professional