Link SDK

npm install @handled/link-sdk

import authenticate from '@handled/link-sdk';

// Get link token from your backend
const linkToken = 'your-link-token';

authenticate(linkToken)
  .then((response) => {
    console.log('Connected:', response);
    // {result: 'success', integration: 'shiphero', integrated_account_id: 'acc_123'}
  })
  .catch((error) => {
    console.log('Error:', error);
  });

curl -X POST 'https://api.usehandled.io/api/v1/ipaas/link-token' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "tenant_id": "customer-123"
  }'

{
  result: 'success',
  integration: 'shiphero',
  integrated_account_id: 'acc_123'
}

authenticate(linkToken).catch((error) => {
  if (error.type === 'validation_error') {
    // Credentials invalid
  } else if (error.type === 'user_closed') {
    // User closed popup
  } else {
    // Other error
  }
});

https://ipaas.usehandled.io/connect-account?link_token={link_token}

import { useState } from 'react';
import authenticate from '@handled/link-sdk';

function ConnectButton({ linkToken }) {
  const [loading, setLoading] = useState(false);

  const handleConnect = async () => {
    setLoading(true);
    try {
      const result = await authenticate(linkToken);
      console.log('Connected:', result);
    } catch (error) {
      console.error('Connection failed:', error);
    } finally {
      setLoading(false);
    }
  };

  return (
    <button onClick={handleConnect} disabled={loading}>
      {loading ? 'Connecting...' : 'Connect Account'}
    </button>
  );
}