Skip to main content

Quickstart

Connect your first data source and destination in 5 minutes.

Step 1: Create an Account​

  1. Go to landed.dev and click Get Started
  2. Sign up with your email, Google, or GitHub account

Step 2: Add a Destination​

Before connecting a data source, you need a destination where your data will land.

  1. In the dashboard, click Destinations in the sidebar
  2. Click Add Destination
  3. Choose your destination type (e.g., BigQuery, Snowflake, PostgreSQL)
  4. Follow the setup guide for your destination:
  5. Click Test Connection to verify, then Save

Step 3: Add a Connector​

  1. Click Connectors in the sidebar
  2. Click Add Connector
  3. Browse or search the connector catalog
  4. Select a connector (e.g., Stripe, HubSpot, GitHub)
  5. Enter the required credentials (API key, OAuth, etc.)
  6. Click Test Connection to verify your credentials
  7. Select the destination you configured in Step 2
  8. Click Save

Step 4: Select Streams​

After creating a connector, you can choose which data streams to sync:

  1. Go to your connector's detail page
  2. Click the Streams tab
  3. Toggle on the streams you want to sync (e.g., customers, invoices)
  4. Click Save

Step 5: Trigger Your First Sync​

  1. On your connector's detail page, click Sync Now
  2. Watch the sync progress in real time
  3. Once complete, check your destination -- your data is there

What Happens Next​

  • Syncs run automatically on the schedule you configured (default: every 6 hours)
  • Landed uses incremental sync for most streams, so only new and changed records are fetched
  • If a sync fails, Landed retries automatically with exponential backoff
  • You can monitor sync history and health from the dashboard

Optional: Set Up Webhooks​

Get notified when syncs complete or fail:

  1. Go to Settings > Webhooks (or use the Webhooks API)
  2. Add your endpoint URL
  3. Select the events you want to receive (sync.completed, sync.failed, schema.changed)

See the Webhooks guide for payload formats and signature verification.

Optional: Use the API​

Manage everything programmatically:

  1. Go to Settings > API Keys
  2. Create an API key (starts with lnd_)
  3. Use it as a Bearer token in your API calls
curl -H "Authorization: Bearer lnd_your_key_here" \
  https://api.landed.dev/connectors

See the API Reference for all available endpoints.