Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.runmorph.dev/llms.txt

Use this file to discover all available pages before exploring further.

Morph’s Proxy feature enables direct access to any connector’s native API endpoints while handling authentication automatically. This gives you the flexibility to use platform-specific features beyond our unified models.

Key Features

✓ Direct access to native APIs ✓ Automatic authentication handling ✓ Request/response transformation ✓ Rate limiting protection ✓ Error handling

Quick Start

import { Morph } from "@runmorph/cloud";

// Initialize morph client
const morph = new Morph({
  publicKey: "pk_live_xxxxxxx",
  secretKey: "sk_live_xxxxxxx",
});

// Load a connection
const connection = morph.connections({
  connectorId: "hubspot",
  ownerId: "customer-123",
});

// Make a direct API call to HubSpot
const response = await connection.proxy({
  method: "GET",
  path: "/crm/v3/objects/contacts",
  query: {
    limit: 100,
  },
});

Benefits

  • Maximum Flexibility: Access any API endpoint
  • Simplified Auth: No token management needed
  • Error Protection: Standardized error handling
  • Future Proof: Works with new API versions
  • Development Speed: Quick implementation of custom features

Best Practices

  1. Use Unified Models First:
    • Start with our unified models when possible
    • Use proxy for platform-specific features
  2. Error Handling:
    • Always handle potential errors
    • Check rate limits
    • Implement retries for failed requests
  3. Performance:
    • Batch requests when possible
    • Cache responses when appropriate
    • Monitor API usage

Getting Started

For detailed API documentation and examples, visit our Proxy API Reference.