Finch
Read Finch unified employment, payroll, and connection management data.
Tools
| Name | Description |
|---|---|
get_companyRead company information for the connected employer. | Read company information for the connected employer. |
list_directoryRead the company directory and organization structure. | Read the company directory and organization structure. |
get_individualsRead individual employee/person records by request array. | Read individual employee/person records by request array. |
get_employmentsRead employment records by request array. | Read employment records by request array. |
list_paymentsRead payroll payments for a date range. | Read payroll payments for a date range. |
get_pay_statementsRead pay statements by request array. | Read pay statements by request array. |
list_providersList Finch providers. | List Finch providers. |
introspect_connectionInspect the employer/provider connection and granted products for the access token. | Inspect the employer/provider connection and granted products for the access token. |
disconnect_connectionDisconnect all entities associated with this Finch access token and revoke the connection. | Disconnect all entities associated with this Finch access token and revoke the connection. |
disconnect_entityDisconnect specific entities from a multi-entity Finch connection. | Disconnect specific entities from a multi-entity Finch connection. |
request_forwardingUse Finch Request Forwarding for a provider-supported custom data request. | Use Finch Request Forwarding for a provider-supported custom data request. |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('finch', 'get_company', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'finch',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
How do I connect Finch to my app?
Use Weavz Hosted Connect for Custom authentication. Install the SDK, create a connection through the connect portal or API, then execute tools programmatically.
What tools does Finch support?
Finch supports 11 tools including Get Company, List Directory, Get Individuals, Get Employments, List Payments, and more.
Can I use Finch with AI agents?
Yes. Add Finch to an MCP server in Tool Mode or Code Mode. Code Mode provides 3 meta-tools with on-demand API discovery so agents can compose stateful workflows without loading every action schema up front.
Can Finch be used in stateful agent workflows?
Yes. Agents can combine Finch tools with Filesystem, State KV, Human Gates, input partials, and other workspace integrations while keeping execution scoped to the selected workspace or end user.
What authentication does Finch use?
Finch uses Custom. Weavz stores credentials securely and uses them for authorized action execution.
How much does the Finch integration cost?
The Finch integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.
Connect Finch in minutes
Get 20,000 free action executions every month. No credit card required.