← All documentation

Getting started

This guide walks you from signup to your first successful sync in under 10 minutes.

1. Create an account

Visit plugsync.com/signup and sign up with your work email. We’ll send a verification link — click it, then set a password.

After verification you land on the dashboard. Your organization starts on the Developer tier (1 connected system, 2,000 events/month).

2. Connect HubSpot

From the dashboard, click Connect HubSpot. You’ll be redirected to HubSpot’s OAuth screen. Choose your portal, review the requested scopes, and approve.

We never see or store your HubSpot password. We retain only the OAuth refresh token, encrypted at rest.

3. Create your first connector

Click Create connector. You can either:

For this guide we’ll use a template. Pick “Generic Webhook → HubSpot Contact”, give it a name, and click Use this template.

4. Send your first event

The connector exposes an endpoint at /api/v1/events. Send a test event with curl:

curl -X POST https://app.plugsync.com/api/v1/events \
  -H "x-api-key: YOUR_CONNECTOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "contact_upserted",
    "data": {
      "external_id": "user-42",
      "email": "[email protected]"
    }
  }'

Replace YOUR_CONNECTOR_API_KEY with the connector API key (ps_live_...) shown under Connectors → [your connector] → API keys, sent in the x-api-key header (not a Bearer token).

5. Watch the sync

Within a few seconds the contact appears in HubSpot. The dashboard shows the event in Recent activity with status synced. If anything failed, click the event for the full execution trace and the agent’s suggested fix.

What’s next