Fieldvault CRM

Overview

The Fieldvault CRM connector provides type-safe access to leads, contacts, accounts, opportunities, activities, and cases via OAuth2. Fieldvault uses cursor-based pagination — each page response includes a next_cursor field that the SDK tracks automatically when you call .autopage(). Rate limit is 100 req/sec; the SDK's per-connector retry profile handles 429s with exponential backoff and full-jitter, so your code never needs to see a rate limit error.

Supported Objects

• Contacts
• Accounts
• Opportunities
• Leads
• Activities
• Cases
• Tasks

Authentication

This connector uses OAuth2. Configure it once at client creation:

import { dlx } from 'devloom';

const client = dlx.client({
  connector: 'fieldvault-crm',
  auth: dlx.auth.oauth2({
    clientId: process.env.FIELDVAULT_CRM_CLIENT_ID,
    clientSecret: process.env.FIELDVAULT_CRM_SECRET,
    scopes: ['api'],
    autoRefresh: true
  })
});

Querying Records

// Fetch all active records with auto-pagination
const records = await client
  .query('contacts')
  .filter({ status: 'active' })
  .autopage()
  .all();

console.log(`Fetched ${records.length} records`);

Webhook Events

const sub = client
  .stream('contacts.updated')
  .on('event', (e) => {
    console.log('Changed:', e.record.id);
  });

// Cleanup
sub.close();

Pagination

This connector uses Cursor-based pagination. The SDK handles it transparently — use .autopage() to fetch all pages or .limit(n) + .page(n) for manual control.