Documentation

    HubSpot

    Read CRM records from HubSpot into a Strata flow. Oplema can't write to HubSpot.

    Before you start

    • A HubSpot account with access to the records you want to read.
    • Required permissions: oauth, crm.objects.contacts.read, crm.objects.companies.read and crm.objects.deals.read.
    • Optional permissions, which unlock more objects if granted: crm.objects.tickets.read, crm.objects.products.read, crm.objects.line_items.read, crm.objects.custom.read and sales-email-read.
    • Requests to HubSpot come from Oplema's servers, not your browser. If your HubSpot account restricts access by network, it must allow them. Oplema doesn't promise a fixed IP address; contact us if you need to allowlist.

    Connect

    1. In Strata, select an Input block.
    2. Set Source to Connectors.
    3. In the connector dropdown below it, choose HubSpot.
    4. Open the Connection dropdown and choose Create new connection.
    5. Set Name (optional). Without a name, the connection is labeled with your HubSpot domain.
    6. Select Connect to HubSpot. HubSpot's own sign-in opens in a popup. Approve access there.

    The popup closes, the new connection is selected and the pickers below it load. If access later expires or you need more permissions, select the connection, then select Reconnect to HubSpot.

    Read

    SettingWhat it does
    ObjectOnly objects your connection can access appear: Contacts, Companies, Deals, Tickets, Products, Line items, Emails, Calls, Meetings, Notes, Tasks and custom objects. Reconnect to grant access to more.
    Archived onlySelect to read only archived records.
    ColumnsSelected columns starts with a suggested set for standard objects, or use All columns. Record metadata is always included.
    Related record linksAdds the IDs and labels of related records, not the records themselves.

    Select Refresh data to read again.

    Limits and billing

    • Reads: the first 50 MB of each download is free. After that, each download costs $0.01 per GB from your usage. Failed reads aren't charged, and a read stops when your usage runs out.
    • Rate-limited or failed requests are retried up to twice.

    See Billing for who pays and how usage works.

    Troubleshooting

    MessageWhat to do
    HubSpot: HTTP 401. Reconnect your HubSpot account.Select Reconnect to HubSpot.
    HubSpot: HTTP 403. This connection or account cannot access the selected data. Check permissions or reconnect.Check your HubSpot permissions, then reconnect.
    HubSpot: selected object is unavailable; check permissions or reconnectReconnect and grant the object, or choose another.
    HubSpot: reconnect to verify granted permissionsSelect Reconnect to HubSpot.
    HubSpot: Select at least one columnSelect a column, or choose All columns.
    HubSpot: property <name> is unavailable; select properties againThe property was removed or renamed. Select columns again.
    This transfer exceeds the free 50 MB and the available usage creditsThe read passed 50 MB and your usage ran out. Add usage, or read less data.

    Prepare your data. Build it in Strata.

    Strata opens in your browser, with no account.