Skip to main content

​
Why Validate

Without validation, users can connect accounts that:
  • Have invalid API keys
  • Lack required permissions
  • Can’t access needed resources
Validation catches these issues during connection, not during production API calls.

​
Enable Validation

1

Open Settings

Go to your integration settings
2

Enable

Enable Connection Validation

​
Configure Validation

​
Select Data Source

FieldDescription
Request TypeUnified API or Proxy API
ResourceEndpoint to test (e.g., wms/orders)
Methodlist or get
QueryOptional filter parameters

​
How It Works

During connection, Handled makes the configured API call:
  • Success - Account is validated and activated
  • Failure - User sees an error and can fix their credentials

​
Example

For a ShipHero integration:
SettingValue
Request TypeUnified API
Resourcewms/orders
Methodlist
Query{"limit": 1}
This verifies the user can access orders before completing the connection.
Choose a lightweight endpoint for validation to keep connection times fast.