Skip to main content
modiva.ai
Anmelden
← Alle Hilfeartikel

Verbinden

HubSpot

CRMOAuthHubSpot Entwicklerdokumentation ↗

HubSpot connects through OAuth 2.0. You authorize Modiva from HubSpot's own consent screen and pick the account (portal) to connect — Modiva then reads and writes your contacts and deals through one unified API and MCP server. HubSpot access tokens are short-lived; Modiva refreshes them automatically so your connection stays healthy without you reconnecting.

Bevor Sie beginnen

  • A HubSpot account, and access to the portal you want to connect.
  • Permission in that portal to approve a connected app (typically a Super Admin or a user with app-install rights).

Schritt-für-Schritt-Einrichtung

  1. 1

    Sign in to Modiva

    Log in at modiva.ai and open the Dashboard. You need a Modiva account before you can connect any platform — creating one takes a minute and no credit card is required for the free tier.

    The Modiva dashboard after signing in
    The Modiva dashboard — your home for connections, posts and analytics.
  2. 2

    Open Connections → New connection

    In the left sidebar choose Connections, then click New connection. You'll see the full catalogue of platforms grouped by category (Social, Ads and CRM).

    The New connection picker listing every platform
    The connection picker. Use the search box or category filter to find your platform.
  3. 3

    Select HubSpot

    Click the HubSpot card. Modiva redirects you to HubSpot's official sign-in and permission screen — your password is entered on HubSpot, never on Modiva.

    Selecting the HubSpot card in the connection picker
    Click Connect on the HubSpot card to start the secure OAuth flow.
  4. 4

    Authorize Modiva on HubSpot

    Review the permissions Modiva is requesting and approve them. If you manage more than one account, page or profile, pick the one you want Modiva to manage.

    The HubSpot permission / consent screen
    HubSpot's consent screen. Approve the requested scopes to continue.
  5. 5

    You're connected

    HubSpot now sends you back to Modiva and the connection appears with a green Connected status. From here it's available to every MCP key and API call in your workspace.

    The HubSpot connection showing a Connected status
    A healthy connection shows a green dot and the connected account name.

Berechtigungen, die Modiva anfordert

Wenn Sie HubSpot verbinden, fordert Modiva nur den Zugriff an, der zum Ausführen der von Ihnen genutzten Tools nötig ist. Sie können ihn jederzeit über HubSpot oder durch Trennen in Modiva widerrufen.

  • Read your account (portal) identity
  • Read and write contacts
  • Read and write deals
  • Stay connected by refreshing access tokens

Fehlerbehebung & FAQ

Where is my HubSpot password stored?

Nowhere. You sign in on the provider's own site and Modiva only receives a scoped access token, which is encrypted at rest with AES-256-GCM. Modiva never sees your password.

My connection says Expired or Error — what do I do?

Open Connections, find the platform and click Reconnect (or Refresh token). Providers periodically expire tokens or revoke them when you change your password; reconnecting re-runs the consent screen and restores access.

How do I disconnect?

Open Connections, click the HubSpot row and choose Disconnect. Modiva deletes the stored token immediately. You can also revoke Modiva from inside HubSpot's own app settings.

Which HubSpot account gets connected?

The portal you're signed into when you approve the consent screen. If you manage several HubSpot accounts, switch to the one you want before authorizing, or use HubSpot's account picker during the flow.

Do I need a paid HubSpot plan?

No. The contacts and deals APIs Modiva uses are available on HubSpot's free CRM. Some advanced objects may require a paid tier, but connecting and managing contacts and deals works on Free.

My token keeps needing refresh — is that a problem?

No. HubSpot access tokens expire about every 30 minutes by design. Modiva stores a refresh token and renews access automatically in the background, so you won't be asked to reconnect unless you revoke access in HubSpot.

Brauchen Sie Hilfe mit HubSpot?

Fin kann Folgefragen beantworten und Sie durch jeden Schritt führen.


HubSpot-Playbooks

Verbunden? Setzen Sie HubSpot mit diesen kostenlosen Wachstums-Playbooks ein.

How to Turn Social Media Engagement Into HubSpot Pipeline
Connect HubSpot — Modiva