Twenty icon

Twenty

Interact with the Twenty API

Actions25

Company → Match

AI-generated

Overview

This node interacts with the Twenty API to match company records based on provided criteria. It is useful for workflows that need to identify or verify company information by matching either the company's website domain or exact name. For example, it can be used in CRM integrations to find existing company records before creating new ones, or in data enrichment processes to validate company details.

Use Case Examples

  1. Match a company by its website domain to retrieve its record.
  2. Fallback to matching by company name if the domain is not available.
  3. Control the depth of returned data to include related records or just the primary company record.

Properties

Name Meaning
Base URL Base URL for the Twenty workspace REST API, including the /rest suffix.
Domain Website domain used to locate an existing company record (primaryLinkUrl).
Name Exact company name to match when a domain is unavailable.
Fallback Strategy Strategy to use for matching companies, such as trying domain first then name, domain only, name only, or either domain or name in a single request.
Depth Controls whether related records are expanded in the response (primary record only or include direct relations).
Request Options Additional request options such as batching, SSL certificate validation, proxy settings, and timeout configuration.

Output

JSON

  • company - The matched company record data returned from the Twenty API, including expanded related records if requested.

Dependencies

  • Requires an API key credential for authentication with the Twenty API.

Troubleshooting

  • Ensure the Base URL is correctly set with the /rest suffix to avoid connection errors.
  • If matching fails, verify that the domain or name provided is accurate and exists in the Twenty workspace.
  • Timeout errors may occur if the server is slow; adjust the timeout setting accordingly.
  • SSL certificate validation errors can be bypassed by enabling the 'Ignore SSL Issues' option, but this reduces security.
  • Proxy settings must be correctly configured if used, including authentication details if required.

Discussion