> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Easyship

> 48 actions available for Easyship through StackOne. Use via Actions RPC, Toolset SDK, MCP, or A2A.

export const GettingStarted = ({connector}) => {
  const linkStyle = {
    textDecoration: 'none'
  };
  const authConfigGuides = connector?.authentication?.filter(a => a?.setupGuide) ?? [];
  const linkAccountGuides = connector?.authentication?.filter(a => a?.configGuide) ?? [];
  return <div style={{
    marginTop: '32px',
    paddingTop: '24px',
    borderTop: '1px solid #e2e8f0'
  }}>
      <div style={{
    fontSize: '20px',
    fontWeight: '600',
    marginBottom: '12px'
  }}>Getting Started</div>
      <Steps>
        <Step title="Create or Select a Project">
          Set up a new project or select an existing one. See the <a href="/guides/managing-projects" style={linkStyle}>Projects Guide</a>.
        </Step>
        <Step title="Configure the Connector">
          <>
            Enable the connector and set up auth configuration in your project. See <a href="/guides/explore-connectors" style={linkStyle}>Managing Connectors</a>.
            {authConfigGuides.length > 0 && <>
              <Columns cols={2}>
                {authConfigGuides.map(auth => <Card title="Auth Config" href={`/${auth.setupGuide}`} icon={connector.icon} horizontal>
                    {connector.name} - {auth.label}
                  </Card>)}
              </Columns> 
              </>}
          </>
        </Step>
        <Step title="Link an Account">
          <>
            Connect an account using <a href="/guides/embedding-stackone-hub" style={linkStyle}>StackOne Hub</a> or <a href="/guides/auth-link" style={linkStyle}>Auth Link</a>.
            {linkAccountGuides.length > 0 && <>
                <Columns cols={2}>
                  {linkAccountGuides.map(auth => <Card title="Link Account" href={`/${auth.configGuide}`} icon={connector.icon} horizontal>
                      {connector.name} - {auth.label}
                    </Card>)}
                </Columns>
              </>}
          </>
        </Step>
        <Step title="Use Actions">
          <>
            Invoke actions using one of the methods below:
            <ul style={{
    marginTop: '8px',
    paddingLeft: '20px'
  }}>
              <li style={{
    marginBottom: '4px'
  }}><a href="/mcp/quickstart" style={linkStyle}>MCP</a> – Model Context Protocol for AI assistants</li>
              <li style={{
    marginBottom: '4px'
  }}><a href="/a2a/quickstart" style={linkStyle}>A2A</a> – Agent-to-Agent protocol</li>
              <li style={{
    marginBottom: '4px'
  }}><a href="/agents/typescript/introduction" style={linkStyle}>AI Toolset (TypeScript)</a> – TypeScript SDK for AI agents</li>
              <li style={{
    marginBottom: '4px'
  }}><a href="/agents/python/introduction" style={linkStyle}>AI Toolset (Python)</a> – Python SDK for AI agents</li>
              <li style={{
    marginBottom: '4px'
  }}><a href="/platform/api-reference/actions/make-an-rpc-call-to-an-action" style={linkStyle}>Actions RPC</a> – Direct API calls</li>
              <li style={{
    marginBottom: '4px'
  }}><a href="/guides/playground" style={linkStyle}>Playground</a> – Test actions in the dashboard</li>
            </ul>
          </>
        </Step>
      </Steps>
    </div>;
};

export const ActionsLibrary = ({search, setSearch, filtered, sharedStyles = {}, KeyCell, ScopesCell, availableScopes, selectedScopes, setSelectedScopes}) => {
  const libraryStyles = {
    section: {
      marginTop: '24px',
      marginBottom: '16px'
    },
    sectionTitle: {
      fontSize: '18px',
      fontWeight: '600',
      marginBottom: '12px'
    },
    filterRow: {
      display: 'flex',
      gap: '12px',
      marginBottom: '12px',
      alignItems: 'stretch'
    },
    count: {
      color: '#64748b',
      fontSize: '12px',
      marginBottom: '8px'
    },
    scopesFilterRow: {
      marginBottom: '12px'
    },
    scopesDropdown: {
      display: 'inline-block',
      fontSize: '12px',
      color: '#475569'
    },
    scopesSummary: {
      cursor: 'pointer',
      padding: '6px 10px',
      borderRadius: '999px',
      border: '1px solid #e2e8f0',
      backgroundColor: '#ffffff',
      listStyle: 'none',
      display: 'inline-flex',
      alignItems: 'center',
      gap: '6px'
    },
    scopesSummaryLabel: {
      margin: 0,
      padding: 0
    },
    scopesChipsContainer: {
      marginTop: '8px',
      padding: '4px 2px 2px',
      display: 'flex',
      flexWrap: 'wrap',
      gap: '6px',
      maxHeight: '90px',
      overflowY: 'auto'
    },
    scopeChip: {
      borderRadius: '999px',
      border: '1px solid #e2e8f0',
      padding: '4px 8px',
      fontSize: '11px',
      backgroundColor: '#f8fafc',
      color: '#475569',
      cursor: 'pointer'
    },
    scopeChipActive: {
      backgroundColor: '#dbeafe',
      borderColor: '#2563eb',
      color: '#1d4ed8'
    },
    tableContainer: {
      maxHeight: '500px',
      overflowY: 'auto',
      overflowX: 'auto',
      border: '1px solid #e2e8f0',
      borderRadius: '8px',
      fontSize: '13px'
    },
    gridTable: {
      display: 'grid',
      minWidth: '600px',
      gridTemplateColumns: '200px 1fr'
    },
    gridTableWithScopes: {
      gridTemplateColumns: '200px 1fr 150px'
    },
    gridHeader: {
      display: 'contents'
    },
    gridHeaderCell: {
      position: 'sticky',
      top: 0,
      backgroundColor: '#f8fafc',
      padding: '10px 12px',
      fontWeight: '600',
      borderBottom: '1px solid #e2e8f0',
      zIndex: 1
    },
    gridRow: {
      display: 'contents'
    },
    gridCellAction: {
      padding: '10px 12px',
      fontWeight: '500',
      borderBottom: '1px solid #f1f5f9'
    },
    gridCellKey: {
      padding: '10px 12px',
      borderBottom: '1px solid #f1f5f9'
    },
    gridCellScopes: {
      padding: '10px 12px',
      borderBottom: '1px solid #f1f5f9',
      color: '#475569',
      fontSize: '12px'
    },
    gridCellDescription: {
      padding: '10px 12px',
      color: '#64748b',
      borderBottom: '1px solid #f1f5f9'
    }
  };
  const styles = {
    ...libraryStyles,
    ...sharedStyles
  };
  const safeAvailableScopes = Array.isArray(availableScopes) ? availableScopes : [];
  const safeSelectedScopes = Array.isArray(selectedScopes) ? selectedScopes : [];
  const hasScopesColumn = safeAvailableScopes.length > 0;
  const hasScopeFilter = safeAvailableScopes.length > 0 && typeof setSelectedScopes === 'function';
  const ScopesCellComponent = ScopesCell || (() => null);
  return <div style={styles.section}>
      <div style={styles.sectionTitle}>Actions</div>
      <div style={styles.filterRow}>
        <SearchBar value={search} onChange={setSearch} placeholder="Search actions" />
        {hasScopeFilter && <FilterDropdown label="Scopes" items={safeAvailableScopes} selectedItems={safeSelectedScopes} onChange={setSelectedScopes} searchPlaceholder="Search scopes..." emptyLabel="No scopes found" />}
      </div>
      <div style={styles.count}>
        {filtered.length === 0 ? '0 actions found' : `${filtered.length} action${filtered.length !== 1 ? 's' : ''}`}
      </div>
      {}
      <div className="not-prose" style={styles.tableContainer}>
        <div style={{
    ...hasScopesColumn ? {
      ...styles.gridTable,
      ...styles.gridTableWithScopes
    } : styles.gridTable
  }}>
          {}
          <div style={styles.gridHeader}>
            <div style={styles.gridHeaderCell}>Action</div>
            <div style={styles.gridHeaderCell}>Description</div>
            {hasScopesColumn && <div style={styles.gridHeaderCell}>Required scopes</div>}
          </div>
          {}
          {filtered.map(a => <div key={a.id} style={styles.gridRow}>
              <div style={styles.gridCellAction}>
                <div>{a.label}</div>
                <div style={{
    marginTop: '4px'
  }}>
                  <KeyCell id={a.id} />
                </div>
              </div>
              <div style={styles.gridCellDescription}>{a.description}</div>
              {hasScopesColumn && <div style={styles.gridCellScopes}>
                  <ScopesCellComponent scopes={a.requiredScopes} actionId={a.id} />
                </div>}
            </div>)}
        </div>
      </div>
    </div>;
};

export const FilterDropdown = ({label, items, selectedItems, onChange, searchPlaceholder = 'Search...', emptyLabel = 'No items found', formatLabel}) => {
  const [dropdownOpen, setDropdownOpen] = React.useState(false);
  const [search, setSearch] = React.useState('');
  const [hoveredItem, setHoveredItem] = React.useState(null);
  const dropdownRef = React.useRef(null);
  const styles = {
    dropdownContainer: {
      position: 'relative'
    },
    dropdownTrigger: {
      display: 'flex',
      alignItems: 'center',
      gap: '8px',
      padding: '10px 14px',
      borderRadius: '8px',
      border: '1px solid #e2e8f0',
      fontSize: '14px',
      backgroundColor: 'white',
      cursor: 'pointer',
      whiteSpace: 'nowrap',
      minWidth: '160px',
      justifyContent: 'space-between'
    },
    dropdownTriggerActive: {
      borderColor: '#068F56',
      backgroundColor: '#f0fdf4'
    },
    dropdownMenu: {
      position: 'absolute',
      top: '100%',
      right: 0,
      marginTop: '4px',
      backgroundColor: 'white',
      border: '1px solid #e2e8f0',
      borderRadius: '8px',
      boxShadow: '0 4px 12px rgba(0,0,0,0.1)',
      zIndex: 50,
      minWidth: '220px',
      maxHeight: '320px',
      display: 'flex',
      flexDirection: 'column'
    },
    dropdownHeader: {
      padding: '8px 12px',
      borderBottom: '1px solid #e2e8f0'
    },
    selectActions: {
      display: 'flex',
      alignItems: 'center',
      gap: '8px',
      marginTop: '6px',
      fontSize: '12px'
    },
    selectActionBtn: {
      background: 'none',
      border: 'none',
      color: '#64748b',
      cursor: 'pointer',
      padding: '2px 4px',
      fontSize: '12px'
    },
    dropdownSearchInput: {
      width: '100%',
      padding: '8px 10px',
      borderRadius: '6px',
      border: '1px solid #e2e8f0',
      fontSize: '13px',
      outline: 'none',
      backgroundColor: '#ffffff'
    },
    dropdownList: {
      overflowY: 'auto',
      maxHeight: '220px',
      padding: '4px 0'
    },
    dropdownItem: {
      display: 'flex',
      alignItems: 'center',
      gap: '10px',
      padding: '8px 12px',
      cursor: 'pointer',
      fontSize: '13px',
      color: '#374151',
      transition: 'background-color 0.1s'
    },
    dropdownItemHover: {
      backgroundColor: '#f8fafc'
    },
    checkbox: {
      width: '16px',
      height: '16px',
      borderRadius: '4px',
      border: '2px solid #d1d5db',
      display: 'flex',
      alignItems: 'center',
      justifyContent: 'center',
      flexShrink: 0
    },
    checkboxChecked: {
      backgroundColor: '#068F56',
      borderColor: '#068F56'
    },
    checkmark: {
      color: 'white',
      fontSize: '10px',
      fontWeight: 'bold'
    },
    dropdownFooter: {
      padding: '8px 12px',
      borderTop: '1px solid #e2e8f0',
      display: 'flex',
      justifyContent: 'space-between',
      alignItems: 'center'
    },
    clearButton: {
      fontSize: '12px',
      color: '#64748b',
      cursor: 'pointer',
      padding: '4px 8px',
      borderRadius: '4px',
      border: 'none',
      background: 'none'
    },
    badge: {
      backgroundColor: '#068F56',
      color: 'white',
      fontSize: '11px',
      fontWeight: '600',
      padding: '2px 6px',
      borderRadius: '10px',
      marginLeft: '4px'
    },
    chevron: {
      fontSize: '10px',
      color: '#64748b',
      transition: 'transform 0.15s'
    },
    noResults: {
      padding: '12px',
      textAlign: 'center',
      color: '#64748b',
      fontSize: '13px'
    }
  };
  const safeSelected = Array.isArray(selectedItems) ? selectedItems : [];
  const formatItemLabel = item => {
    if (typeof formatLabel === 'function') {
      return formatLabel(item);
    }
    return item;
  };
  const filteredItems = React.useMemo(() => {
    if (!search) return items;
    const searchLower = search.toLowerCase();
    return items.filter(item => {
      const labelText = formatItemLabel(item);
      return labelText.toLowerCase().includes(searchLower);
    });
  }, [items, search, formatLabel]);
  const isSelected = item => safeSelected.includes(item);
  const toggleItem = item => {
    const next = isSelected(item) ? safeSelected.filter(v => v !== item) : [...safeSelected, item];
    onChange(next);
  };
  const clearFilters = () => {
    onChange([]);
  };
  const selectAll = () => {
    onChange(items);
  };
  React.useEffect(() => {
    const handleClickOutside = e => {
      if (dropdownRef.current && !dropdownRef.current.contains(e.target)) {
        setDropdownOpen(false);
        setSearch('');
        setHoveredItem(null);
      }
    };
    document.addEventListener('mousedown', handleClickOutside);
    return () => document.removeEventListener('mousedown', handleClickOutside);
  }, []);
  return <div style={styles.dropdownContainer} ref={dropdownRef}>
      <button type="button" onClick={() => setDropdownOpen(!dropdownOpen)} style={{
    ...styles.dropdownTrigger,
    ...safeSelected.length > 0 ? styles.dropdownTriggerActive : {}
  }}>
        <span>
          {label}
          {safeSelected.length > 0 && <span style={styles.badge}>{safeSelected.length}</span>}
        </span>
        <span style={{
    ...styles.chevron,
    transform: dropdownOpen ? 'rotate(180deg)' : 'rotate(0deg)'
  }}>
          ▼
        </span>
      </button>
      {dropdownOpen && <div style={styles.dropdownMenu}>
          <div style={styles.dropdownHeader}>
            <input type="text" placeholder={searchPlaceholder} value={search} onChange={e => setSearch(e.target.value)} style={styles.dropdownSearchInput} autoFocus />
            <div style={styles.selectActions}>
              <button type="button" onClick={selectAll} style={styles.selectActionBtn} onMouseEnter={e => {
    e.target.style.color = '#1e293b';
  }} onMouseLeave={e => {
    e.target.style.color = '#64748b';
  }}>
                Select all
              </button>
              <span style={{
    color: '#e2e8f0'
  }}>|</span>
              <button type="button" onClick={clearFilters} style={styles.selectActionBtn} onMouseEnter={e => {
    e.target.style.color = '#1e293b';
  }} onMouseLeave={e => {
    e.target.style.color = '#64748b';
  }}>
                Clear
              </button>
            </div>
          </div>
          <div style={styles.dropdownList}>
            {filteredItems.length === 0 ? <div style={styles.noResults}>{emptyLabel}</div> : filteredItems.map(item => <div key={item} onClick={() => toggleItem(item)} onMouseEnter={() => setHoveredItem(item)} onMouseLeave={() => setHoveredItem(null)} style={{
    ...styles.dropdownItem,
    ...hoveredItem === item ? styles.dropdownItemHover : {}
  }}>
                  <div style={{
    ...styles.checkbox,
    ...isSelected(item) ? styles.checkboxChecked : {}
  }}>
                    {isSelected(item) && <span style={styles.checkmark}>✓</span>}
                  </div>
                  <span>{formatItemLabel(item)}</span>
                </div>)}
          </div>
        </div>}
    </div>;
};

export const SearchBar = ({value, onChange, placeholder = 'Search...'}) => {
  const baseStyle = {
    padding: '10px 14px',
    borderRadius: '8px',
    border: '1px solid #e2e8f0',
    fontSize: '14px',
    outline: 'none',
    backgroundColor: '#fafafa',
    flex: 1,
    minWidth: 0
  };
  return <input type="text" placeholder={placeholder} value={value} onChange={e => onChange(e.target.value)} style={baseStyle} />;
};

export const ConnectorPage = ({connector}) => {
  const styles = {
    header: {
      display: 'flex',
      alignItems: 'center',
      gap: '12px',
      marginBottom: '24px'
    },
    tagsRow: {
      display: 'flex',
      flexWrap: 'wrap',
      gap: '6px',
      marginTop: '8px'
    },
    releaseTag: {
      display: 'inline-block',
      padding: '2px 8px',
      borderRadius: '4px',
      fontSize: '11px',
      fontWeight: '500'
    },
    betaTag: {
      backgroundColor: '#fef3c7',
      color: '#b45309'
    },
    previewTag: {
      backgroundColor: '#E1E9F4',
      color: '#0D58AE',
      border: '1px solid #BFD5F1'
    },
    categoryTag: {
      display: 'inline-block',
      padding: '2px 8px',
      borderRadius: '4px',
      fontSize: '11px',
      fontWeight: '500',
      backgroundColor: '#f1f5f9',
      color: '#475569'
    },
    icon: {
      width: '48px',
      height: '48px',
      borderRadius: '10px',
      backgroundColor: '#f8fafc',
      padding: '2px'
    },
    title: {
      fontSize: '24px',
      fontWeight: '600'
    },
    subtitle: {
      fontSize: '14px',
      color: '#64748b'
    },
    authDescription: {
      fontSize: '14px',
      color: '#64748b',
      marginTop: 0
    },
    sectionTitle: {
      fontSize: '18px',
      fontWeight: '600',
      marginBottom: '12px'
    },
    authList: {
      paddingLeft: '20px',
      color: '#374151'
    },
    codeWrapper: {
      position: 'relative',
      display: 'inline-flex',
      alignItems: 'center',
      maxWidth: '100%',
      cursor: 'pointer',
      overflowX: 'auto',
      overflowY: 'hidden',
      msOverflowStyle: 'none',
      scrollbarWidth: 'none'
    },
    code: {
      backgroundColor: '#f1f5f9',
      padding: '4px 8px',
      borderRadius: '4px',
      fontSize: '11px',
      color: '#475569',
      display: 'inline-block',
      whiteSpace: 'nowrap',
      transition: 'background-color 0.15s'
    },
    codeHover: {
      backgroundColor: '#e2e8f0'
    },
    codeCopied: {
      backgroundColor: '#d1fae5',
      color: '#065f46'
    },
    tooltip: {
      position: 'absolute',
      top: '100%',
      left: '50%',
      transform: 'translateX(-50%)',
      backgroundColor: '#1e293b',
      color: 'white',
      padding: '6px 10px',
      borderRadius: '6px',
      fontSize: '11px',
      whiteSpace: 'nowrap',
      marginTop: '6px',
      zIndex: 50,
      maxWidth: '300px',
      wordBreak: 'break-all'
    },
    tooltipArrow: {
      position: 'absolute',
      bottom: '100%',
      left: '50%',
      transform: 'translateX(-50%)',
      borderWidth: '5px',
      borderStyle: 'solid',
      borderColor: 'transparent transparent #1e293b transparent',
      zIndex: 50
    },
    tdDescription: {
      padding: '10px 12px',
      color: '#64748b',
      verticalAlign: 'top',
      maxWidth: '400px'
    }
  };
  const [search, setSearch] = React.useState('');
  const [copiedId, setCopiedId] = React.useState(null);
  const [selectedScopes, setSelectedScopes] = React.useState([]);
  const availableScopes = React.useMemo(() => {
    const set = new Set();
    connector.actions.forEach(a => {
      if (Array.isArray(a.requiredScopes)) {
        a.requiredScopes.forEach(s => {
          if (s) set.add(s);
        });
      }
    });
    return Array.from(set).sort();
  }, [connector.actions]);
  const filtered = React.useMemo(() => {
    const searchLower = search.toLowerCase();
    return connector.actions.filter(a => {
      const matchesSearch = a.label.toLowerCase().includes(searchLower) || a.description.toLowerCase().includes(searchLower) || a.id.toLowerCase().includes(searchLower);
      if (!matchesSearch) return false;
      if (selectedScopes.length === 0) return true;
      const scopes = Array.isArray(a.requiredScopes) ? a.requiredScopes : [];
      if (scopes.length === 0) return false;
      return selectedScopes.some(scope => scopes.includes(scope));
    });
  }, [connector.actions, search, selectedScopes]);
  const handleImageError = e => {
    e.target.style.display = 'none';
  };
  const formatCategoryLabel = cat => {
    const acronyms = ['ats', 'crm', 'hris', 'iam', 'lms'];
    if (acronyms.includes(cat.toLowerCase())) {
      return cat.toUpperCase();
    }
    return cat.replace(/_/g, ' ').replace(/\b\w/g, c => c.toUpperCase());
  };
  const ReleaseTag = () => {
    if (!connector.releaseStage || connector.releaseStage === 'ga') return null;
    const tagStyle = connector.releaseStage === 'beta' ? {
      ...styles.releaseTag,
      ...styles.betaTag
    } : {
      ...styles.releaseTag,
      ...styles.previewTag
    };
    return <span style={tagStyle}>
        {connector.releaseStage.charAt(0).toUpperCase() + connector.releaseStage.slice(1)}
      </span>;
  };
  const CategoryTags = () => {
    if (!connector.categories || connector.categories.length === 0) return null;
    return <>
        {connector.categories.map(cat => <span key={cat} style={styles.categoryTag}>
            {formatCategoryLabel(cat)}
          </span>)}
      </>;
  };
  const copyToClipboard = async (text, id) => {
    try {
      await navigator.clipboard.writeText(text);
      setCopiedId(id);
      setTimeout(() => setCopiedId(null), 1500);
    } catch (err) {
      console.error('Failed to copy:', err);
    }
  };
  const CopyChip = ({text, copyId}) => {
    const [isHovered, setIsHovered] = React.useState(false);
    const isCopied = copiedId === copyId;
    if (!text) {
      return null;
    }
    const codeStyle = {
      ...styles.code,
      ...isCopied ? styles.codeCopied : isHovered ? styles.codeHover : {}
    };
    return <div style={styles.codeWrapper} onMouseEnter={() => setIsHovered(true)} onMouseLeave={() => setIsHovered(false)} onClick={() => copyToClipboard(text, copyId)} title="">
        {(isHovered || isCopied) && <div style={styles.tooltip}>
            {isCopied ? '✓ Copied!' : 'Click to copy'}
            <div style={styles.tooltipArrow} />
          </div>}
        <code style={codeStyle}>
          {text}
        </code>
      </div>;
  };
  const KeyCell = ({id}) => <CopyChip text={id} copyId={id} />;
  const ScopesCell = ({scopes, actionId}) => {
    const scopeList = Array.isArray(scopes) ? scopes.filter(Boolean) : [];
    if (scopeList.length === 0) return null;
    return <div style={{
      display: 'flex',
      flexWrap: 'wrap',
      gap: '6px'
    }}>
        {scopeList.map(scope => <CopyChip key={scope} text={scope} copyId={`scopes:${actionId}:${scope}`} />)}
      </div>;
  };
  return <div>
      {}
      <div style={styles.header}>
        <img src={connector.icon} alt={connector.name} style={styles.icon} onError={handleImageError} />
        <div>
          <div style={styles.title}>{connector.name}</div>
          <div style={styles.subtitle}>
            {connector.actions.length} actions · {connector.authentication.length} auth method{connector.authentication.length !== 1 ? 's' : ''}
          </div>
          {connector.releaseStage && connector.releaseStage !== 'ga' || connector.categories && connector.categories.length > 0 ? <div style={styles.tagsRow}>
              <ReleaseTag />
              <CategoryTags />
            </div> : null}
        </div>
      </div>

      {}
      <div style={styles.sectionTitle}>Authentication</div>
      <Columns cols={2}>        
        {connector.authentication.length > 0 ? connector.authentication.map(auth => {
    const authLabel = auth?.label || '';
    const authDescription = auth?.description;
    const configGuide = auth?.configGuide;
    const setupGuide = auth?.setupGuide;
    const hasConfigGuide = !!configGuide;
    const hasSetupGuide = !!setupGuide;
    const hasAnyGuide = hasConfigGuide || hasSetupGuide;
    return <Card key={authLabel} title={authLabel}>
                {authDescription && <p style={{
      ...styles.authDescription,
      marginBottom: hasAnyGuide ? '8px' : 0
    }}>
                    {authDescription}
                  </p>}
                {hasAnyGuide && <span style={{
      fontSize: '14px'
    }}>
                    Guides: {hasSetupGuide && <a href={`/${setupGuide}`} style={{
      textDecoration: 'none'
    }}>Auth Config</a>}
                    {hasConfigGuide && hasSetupGuide && ', '}
                    {hasConfigGuide && <a href={`/${configGuide}`} style={{
      textDecoration: 'none'
    }}>Link Account</a>}
                  </span>}
              </Card>;
  }) : <>
            Contact StackOne for authentication details.
          </>}
      </Columns>

      {connector.documentation?.references?.length > 0 && <>
          <div style={styles.sectionTitle}>References</div>
          <Columns cols={2}>
            {connector.documentation.references.map(ref => {
    let safeHref;
    try {
      const parsed = new URL(ref.url);
      safeHref = parsed.protocol === 'http:' || parsed.protocol === 'https:' ? ref.url : undefined;
    } catch {
      safeHref = undefined;
    }
    return <Card key={`${ref.title}-${ref.url}`} title={ref.title} href={safeHref}>
                  {ref.description}
                </Card>;
  })}
          </Columns>
        </>}

      <ActionsLibrary search={search} setSearch={setSearch} filtered={filtered} sharedStyles={{
    sectionTitle: styles.sectionTitle
  }} KeyCell={KeyCell} ScopesCell={ScopesCell} availableScopes={availableScopes} selectedScopes={selectedScopes} setSelectedScopes={setSelectedScopes} />

      <GettingStarted connector={connector} />

    </div>;
};

export const connector = {
  "key": "easyship",
  "name": "Easyship",
  "icon": "https://stackone-logos.com/api/easyship/filled/png",
  "authentication": [{
    "label": "Access Token",
    "description": "Bearer token authentication provides secure access to Easyship APIs. Generate your API access token from the Easyship da...",
    "configGuide": "connectors/easyship/guides/link-account/access-token",
    "setupGuide": "connectors/easyship/guides/auth-config/access-token"
  }],
  "actions": [{
    "id": "easyship_get_account",
    "label": "Get Account",
    "description": "Retrieve information about current account",
    "requiredScopes": ["public.address:read", "public.credit:read", "public.payment_source:read"]
  }, {
    "id": "easyship_get_account_settings",
    "label": "Get Account Settings",
    "description": "Retrieve account settings",
    "requiredScopes": ["public.setting:read"]
  }, {
    "id": "easyship_list_countries",
    "label": "List Countries",
    "description": "Retrieve a list of countries",
    "requiredScopes": ["public.reference:read"]
  }, {
    "id": "easyship_list_states",
    "label": "List All States",
    "description": "Retrieve a list of states",
    "requiredScopes": ["public.reference:read"]
  }, {
    "id": "easyship_list_addresses",
    "label": "List All Addresses",
    "description": "Retrieve a list of all addresses ordered by date of creation",
    "requiredScopes": ["public.address:read"]
  }, {
    "id": "easyship_validate_address",
    "label": "Validate A Single Address",
    "description": "Create an address validation for international addresses",
    "requiredScopes": ["public.address_validation:write"]
  }, {
    "id": "easyship_create_address",
    "label": "Create An Address",
    "description": "Create a new address",
    "requiredScopes": ["public.address:write"]
  }, {
    "id": "easyship_update_address",
    "label": "Update An Address",
    "description": "Update an address in your account",
    "requiredScopes": ["public.address:write"]
  }, {
    "id": "easyship_activate_address",
    "label": "Activate An Address",
    "description": "Activate specific address",
    "requiredScopes": ["public.address:write"]
  }, {
    "id": "easyship_deactivate_address",
    "label": "Deactivate An Address",
    "description": "Deactivate specific address",
    "requiredScopes": ["public.address:write"]
  }, {
    "id": "easyship_validate_domestic_address",
    "label": "Validate A Single Domestic (US) Address",
    "description": "Create a domestic address validation for US addresses",
    "requiredScopes": ["public.address_validation_domestic:write"]
  }, {
    "id": "easyship_create_asset",
    "label": "Create Asset",
    "description": "Upload a new asset",
    "requiredScopes": ["public.asset:write"]
  }, {
    "id": "easyship_list_assets",
    "label": "List Assets",
    "description": "Retrieve a list of assets",
    "requiredScopes": ["public.asset:read"]
  }, {
    "id": "easyship_update_asset",
    "label": "Update Asset",
    "description": "Update an existing asset",
    "requiredScopes": ["public.asset:write"]
  }, {
    "id": "easyship_delete_asset",
    "label": "Delete Asset",
    "description": "Delete an asset",
    "requiredScopes": ["public.asset:write"]
  }, {
    "id": "easyship_deactivate_asset",
    "label": "Deactivate Asset",
    "description": "Deactivate a specific asset",
    "requiredScopes": ["public.asset:write"]
  }, {
    "id": "easyship_activate_asset",
    "label": "Activate Asset",
    "description": "Activate a specific asset",
    "requiredScopes": ["public.asset:write"]
  }, {
    "id": "easyship_list_boxes",
    "label": "List All Boxes",
    "description": "Retrieve a list of available courier boxes and your custom boxes",
    "requiredScopes": ["public.box:read"]
  }, {
    "id": "easyship_create_box",
    "label": "Create A Box",
    "description": "Create a box",
    "requiredScopes": ["public.box:write"]
  }, {
    "id": "easyship_update_box",
    "label": "Update A Box",
    "description": "Update a box in your account",
    "requiredScopes": ["public.box:write"]
  }, {
    "id": "easyship_delete_box",
    "label": "Delete A Box",
    "description": "Delete a box from your account",
    "requiredScopes": ["public.box:write"]
  }, {
    "id": "easyship_list_couriers",
    "label": "List All Couriers",
    "description": "Retrieve a list of active couriers",
    "requiredScopes": ["public.courier:read"]
  }, {
    "id": "easyship_create_courier",
    "label": "Create A Courier",
    "description": "Create a new courier account",
    "requiredScopes": ["public.courier:write"]
  }, {
    "id": "easyship_get_courier",
    "label": "Get A Courier",
    "description": "Retrieve details of a courier",
    "requiredScopes": ["public.courier:read"]
  }, {
    "id": "easyship_delete_courier",
    "label": "Delete A Courier",
    "description": "Delete a LYOC courier",
    "requiredScopes": ["public.courier:write"]
  }, {
    "id": "easyship_list_courier_services",
    "label": "List All Courier Services Of A Courier",
    "description": "Retrieve a list of courier services for selected courier",
    "requiredScopes": ["public.courier_service:read"]
  }, {
    "id": "easyship_list_lyoc",
    "label": "List All LYOC",
    "description": "Retrieve a list of available LYOC",
    "requiredScopes": ["public.courier:read"]
  }, {
    "id": "easyship_create_label",
    "label": "Create Label",
    "description": "Create a new label for an existing shipment",
    "requiredScopes": ["public.label:write"]
  }, {
    "id": "easyship_create_shipment",
    "label": "Create Shipment",
    "description": "Create a new shipment",
    "requiredScopes": ["public.shipment:write"]
  }, {
    "id": "easyship_list_shipments",
    "label": "List Shipments",
    "description": "Retrieve a list of shipments with optional filters",
    "requiredScopes": ["public.shipment:read"]
  }, {
    "id": "easyship_get_shipment",
    "label": "Get Shipment",
    "description": "Retrieve details of a specific shipment",
    "requiredScopes": ["public.shipment:read"]
  }, {
    "id": "easyship_update_shipment",
    "label": "Update Shipment",
    "description": "Update shipment details",
    "requiredScopes": ["public.shipment:write"]
  }, {
    "id": "easyship_delete_shipment",
    "label": "Delete Shipment",
    "description": "Delete a shipment that has not yet been shipped",
    "requiredScopes": ["public.shipment:write"]
  }, {
    "id": "easyship_list_all_trackings",
    "label": "List All Trackings",
    "description": "Retrieve tracking status and checkpoint history for shipments",
    "requiredScopes": ["public.track:read"]
  }, {
    "id": "easyship_list_transaction_records",
    "label": "List Transaction Records For A Shipment",
    "description": "List transaction records for a specific shipment",
    "requiredScopes": ["public.transaction_record:read"]
  }, {
    "id": "easyship_list_unavailable_couriers",
    "label": "List Unavailable Couriers For A Shipment",
    "description": "List unavailable couriers and reasons for a specific shipment",
    "requiredScopes": ["public.shipment:read", "public.rate:read"]
  }, {
    "id": "easyship_cancel_shipment",
    "label": "Cancel A Shipment",
    "description": "Cancel a shipment that has been shipped",
    "requiredScopes": ["public.shipment:write"]
  }, {
    "id": "easyship_list_item_categories",
    "label": "List All Item Categories",
    "description": "Retrieve a list of item categories",
    "requiredScopes": ["public.reference:read"]
  }, {
    "id": "easyship_list_hs_codes",
    "label": "List HS Codes",
    "description": "Retrieve a list of HS codes",
    "requiredScopes": ["public.hs_code:read"]
  }, {
    "id": "easyship_list_stores",
    "label": "List All Stores",
    "description": "Retrieve a list of stores",
    "requiredScopes": ["public.store:read"]
  }, {
    "id": "easyship_list_tags",
    "label": "List All Tags",
    "description": "Retrieve a list of tags",
    "requiredScopes": ["public.tag:read"]
  }, {
    "id": "easyship_create_tag",
    "label": "Create A Tag",
    "description": "Create a new tag",
    "requiredScopes": ["public.tag:write"]
  }, {
    "id": "easyship_list_trackings",
    "label": "List All Trackings",
    "description": "Retrieve a list of trackings available with your account",
    "requiredScopes": ["public.track_3p:read"]
  }, {
    "id": "easyship_get_tracking",
    "label": "Get A Tracking",
    "description": "Show a single tracking in your account",
    "requiredScopes": ["public.track_3p:read"]
  }, {
    "id": "easyship_delete_tracking",
    "label": "Delete A Tracking",
    "description": "Delete a single tracking from your account",
    "requiredScopes": ["public.track_3p:write"]
  }, {
    "id": "easyship_create_tracking",
    "label": "Create A Tracking",
    "description": "Create a single tracking in your account",
    "requiredScopes": ["public.track_3p:write"]
  }, {
    "id": "easyship_list_supported_couriers",
    "label": "List Supported Couriers",
    "description": "List supported couriers for tracking",
    "requiredScopes": ["public.track_3p:read"]
  }, {
    "id": "easyship_list_external_courier_services",
    "label": "List External Courier Services",
    "description": "List courier services that do not support label generation but are trackable",
    "requiredScopes": ["public.track_3p:read"]
  }],
  "releaseStage": "preview",
  "categories": ["commerce"],
  "scopeDefinitions": [{
    "name": "public.address:read",
    "description": "Access to view addresses"
  }, {
    "name": "public.address:write",
    "description": "Access to create, update, activate, and deactivate addresses"
  }, {
    "name": "public.address_validation:write",
    "description": "Access to validate international addresses"
  }, {
    "name": "public.address_validation_domestic:write",
    "description": "Access to validate US addresses"
  }, {
    "name": "public.credit:read",
    "description": "Access to credit balance information"
  }, {
    "name": "public.payment_source:read",
    "description": "Access to payment sources information"
  }, {
    "name": "public.asset:read",
    "description": "Access to view assets"
  }, {
    "name": "public.asset:write",
    "description": "Access to create, update, delete, activate, and deactivate assets"
  }, {
    "name": "public.setting:read",
    "description": "Access to view account settings"
  }, {
    "name": "public.reference:read",
    "description": "Access to view reference data such as countries"
  }, {
    "name": "public.shipment:read",
    "description": "Access to view shipments"
  }, {
    "name": "public.shipment:write",
    "description": "Access to create and manage shipments"
  }, {
    "name": "public.label:write",
    "description": "Access to create and manage shipping labels"
  }, {
    "name": "public.track:read",
    "description": "Access to view shipment tracking information"
  }, {
    "name": "public.track_3p:read",
    "description": "Access to view third-party trackings"
  }, {
    "name": "public.track_3p:write",
    "description": "Access to create third-party trackings"
  }, {
    "name": "public.transaction_record:read",
    "description": "Access to view transaction records"
  }, {
    "name": "public.rate:read",
    "description": "Access to view courier rates"
  }, {
    "name": "public.courier:read",
    "description": "Access to view courier information"
  }, {
    "name": "public.courier:write",
    "description": "Access to create and manage couriers"
  }, {
    "name": "public.courier_service:read",
    "description": "Access to view courier services"
  }, {
    "name": "public.tag:read",
    "description": "Access to view tags"
  }, {
    "name": "public.tag:write",
    "description": "Access to create tags"
  }, {
    "name": "public.box:read",
    "description": "Access to view boxes"
  }, {
    "name": "public.box:write",
    "description": "Access to create, update, and delete boxes"
  }, {
    "name": "public.store:read",
    "description": "Access to view stores"
  }, {
    "name": "public.hs_code:read",
    "description": "Access to view HS codes"
  }]
};

<ConnectorPage connector={connector} />