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.