Connect the integration
Connecting your Firmable account to Relevance AI is a straightforward process:- Go to the “Integrations” page in the sidebar of your Relevance AI dashboard.
- Click on “Firmable” from the available integrations.
- Click on the “Add Integration” button.
- Enter your Firmable API key when prompted.
- Once authenticated, your Firmable account will appear as a connected integration.
Tool steps for Firmable
The Firmable integration provides a comprehensive set of actions that your agents can use to enrich leads, find contacts, and gather company intelligence specific to Australian and New Zealand markets. These actions can be incorporated into your agent’s workflows as tool steps, enabling sophisticated sales automation and prospect research capabilities for ANZ businesses.People Enrichment
Firmable: People Enrichment
Firmable: People Search
Company Intelligence
Firmable: Company Enrichment
Advanced API Access
Firmable API Call
Use the integration’s API tool step (Advanced)
In addition to the pre-built actions available in the tool directory, you can build custom tools that perform Firmable-specific activities using the Firmable API Call tool step.How to use the Firmable API Call tool step
Create a new tool
Add the Firmable API Call tool step
- Scroll down to Tool-steps
- Search for “Firmable API Call” in the tool step search bar
- Add the Firmable API Call tool step to your workflow
Configure the API endpoint
- Method: Select the HTTP method (GET, POST)
- Endpoint: Enter the API endpoint path (e.g.,
/enrich/person) - Body: Add any required request body data with search criteria
Example: Enriching a Contact by LinkedIn URL
Here’s a practical example of using the Firmable API Call tool step to enrich a contact using their LinkedIn profile: API Endpoint:POST /enrich/person
Configuration:
- Uses the POST method to request contact enrichment
- Specifies the
/enrich/personendpoint for individual contact lookup - Provides the LinkedIn URL as the search parameter
- Returns verified contact information including email addresses, phone numbers, job title, company details, and location data specific to Australian and New Zealand professionals
Common Firmable API Endpoints
Here are some commonly used Firmable API endpoints you can use with the API Call tool step:Person Enrichment
Person Enrichment
- Enrich by LinkedIn URL:
POST /enrich/personwith{"linkedin_url": "https://linkedin.com/in/username"} - Enrich by email:
POST /enrich/personwith{"email": "user@example.com.au"} - Enrich by LinkedIn slug:
POST /enrich/personwith{"linkedin_slug": "john-doe-au"}
Company Enrichment
Company Enrichment
- Enrich by domain:
POST /enrich/companywith{"domain": "example.com.au"} - Enrich by LinkedIn:
POST /enrich/companywith{"linkedin_url": "https://linkedin.com/company/example"} - Enrich by ABN:
POST /enrich/companywith{"abn": "12345678901"} - Enrich by website:
POST /enrich/companywith{"website": "https://example.com.au"}
People Search
People Search
- Search by company:
POST /search/peoplewith{"company": "Acme Corp"} - Search by position:
POST /search/peoplewith{"position": "Sales Manager"} - Search by seniority:
POST /search/peoplewith{"seniority": "Director"} - Search by department:
POST /search/peoplewith{"department": "Marketing"}
Advanced Filtering
Advanced Filtering
- Combined search criteria: Use multiple filters together for precise targeting
- Location filtering: Target specific Australian states or New Zealand regions
- Company size filtering: Focus on SMBs or enterprise accounts
Example use cases
Here are some ways you can leverage the Firmable integration with your agents for Australian and New Zealand markets:ANZ Lead Enrichment
ANZ Lead Enrichment
Australian Business Research Agent
Australian Business Research Agent
ABN-Based Lead Qualification
ABN-Based Lead Qualification
ANZ Outbound List Builder
ANZ Outbound List Builder
Regional CRM Data Enhancement
Regional CRM Data Enhancement
ANZ Account-Based Marketing Research
ANZ Account-Based Marketing Research
Australian Recruitment Sourcing
Australian Recruitment Sourcing
Trans-Tasman Partnership Development
Trans-Tasman Partnership Development
Best practices
Data Privacy & ANZ Compliance
Data Privacy & ANZ Compliance
- Comply with the Australian Privacy Act and New Zealand Privacy Act
- Only use Firmable data for legitimate business purposes
- Include proper opt-out mechanisms in your outreach
- Store enriched data securely and delete when no longer needed
- Review Firmable’s terms of service and acceptable use policy
- Respect the Australian Spam Act 2003 and New Zealand’s Unsolicited Electronic Messages Act
Credit Management
Credit Management
- Each enrichment request consumes Firmable credits
- Cache enriched data to avoid duplicate lookups
- Implement logic to check if data already exists before enriching
- Monitor your credit usage through Firmable’s dashboard
- Set up alerts when credits are running low
- Prioritize high-value prospects for enrichment
Data Quality for ANZ Markets
Data Quality for ANZ Markets
- Provide as much information as possible in your search queries (LinkedIn URL + email is better than email alone)
- Validate enriched data before using it in outreach
- Implement fallback logic when Firmable doesn’t find a match
- Regularly update enriched data as contact information changes
- Verify ABN numbers for Australian companies to ensure legitimacy
- Consider regional variations in job titles and company structures between AU and NZ
Regional Targeting
Regional Targeting
- Use location filters to target specific Australian states or New Zealand regions
- Consider time zones when scheduling outreach (AEST, AEDT, NZST, NZDT)
- Tailor messaging to local business culture and practices
- Use ABN lookups for Australian companies to verify business registration
- Understand the differences between Australian and New Zealand business environments
Rate Limiting
Rate Limiting
- Firmable enforces rate limits to ensure service quality
- Implement retry logic with exponential backoff for rate limit errors
- Distribute enrichment tasks over time for large datasets
- Monitor API response codes and handle errors appropriately
- Contact Firmable support if you need higher limits for enterprise use
Frequently asked questions (FAQs)
What is Firmable and why should I use it?
What is Firmable and why should I use it?
Do I need a Firmable account to use this integration?
Do I need a Firmable account to use this integration?
How do I get my Firmable API key?
How do I get my Firmable API key?
- Log in to your Firmable account
- Navigate to Settings or Account Settings
- Look for “API Access” or “API Keys”
- Generate a new API key or copy your existing key
- Use this key when connecting Firmable to Relevance AI
What does 'beta' status mean for the Firmable integration?
What does 'beta' status mean for the Firmable integration?
What is an ABN and how do I use it with Firmable?
What is an ABN and how do I use it with Firmable?
- Verifying business legitimacy
- Finding company details for Australian businesses
- Enriching leads with official business registration data
Does Firmable cover both Australia and New Zealand?
Does Firmable cover both Australia and New Zealand?
How many Firmable credits does each enrichment use?
How many Firmable credits does each enrichment use?
- Person enrichment: 1-2 credits per successful lookup
- Company enrichment: 1 credit per successful lookup
- Search operations: Credits vary based on result volume
What happens if Firmable doesn't find a match?
What happens if Firmable doesn't find a match?
- Trying alternative search parameters (e.g., LinkedIn URL instead of email)
- Using fallback data sources
- Flagging the record for manual research
- Skipping to the next record in bulk operations
Can I use Firmable for cold outreach in Australia and New Zealand?
Can I use Firmable for cold outreach in Australia and New Zealand?
- Follow the Australian Spam Act 2003 and New Zealand’s Unsolicited Electronic Messages Act
- Include proper identification and opt-out mechanisms
- Only contact people with legitimate business interest
- Respect do-not-contact lists and preferences
- Review Firmable’s acceptable use policy
How accurate is Firmable's ANZ data?
How accurate is Firmable's ANZ data?
- Use the most recent enrichment data available
- Implement email verification before sending campaigns
- Update your records regularly
- Verify ABN numbers for Australian companies
- Have a process for handling bounced emails or wrong numbers
- Consider that ANZ business data may update less frequently than global databases
Can I enrich contacts from LinkedIn profiles?
Can I enrich contacts from LinkedIn profiles?
What's the difference between the enrichment and search tool steps?
What's the difference between the enrichment and search tool steps?
- Enrichment tool steps: Used when you have specific identifying information (LinkedIn URL, email, ABN, domain) and want to retrieve that specific contact or company’s details
- Search tool steps: Used when you want to discover contacts matching certain criteria (company, position, seniority, department) within the ANZ market
Can I integrate Firmable with my CRM?
Can I integrate Firmable with my CRM?
- Pull ANZ contacts from your CRM
- Enrich them with Firmable
- Update the CRM with enriched data including ABN numbers
- All automatically on a schedule or trigger
Are there rate limits for the Firmable API?
Are there rate limits for the Firmable API?
- Your agent will receive a rate limit error
- Implement retry logic with delays
- Distribute enrichment tasks over time
- Contact Firmable support if you need higher limits

