Plain icon

Plain

Interact with Plain API

Actions23

Company → Get

AI-generated

Overview

This node interacts with the Plain API to manage company data. Specifically, the "Company" resource with the "Get" operation allows you to retrieve detailed information about a company either by its unique Plain company ID or by its domain name.

Common scenarios where this node is beneficial include:

  • Fetching company details for integration workflows that require company metadata.
  • Enriching customer records with company information based on domain names.
  • Automating business processes that depend on company attributes such as contract value, tier, or account owner.

Practical example:

  • You have a list of domain names from incoming leads and want to fetch corresponding company details automatically to personalize outreach campaigns.

Properties

Name Meaning
Get By Method to identify the company: either by "Company ID" (Plain company ID) or "Domain Name".
Company ID The unique Plain company ID used to fetch the company when "Get By" is set to "Company ID".
Domain Name The domain name of the company used to fetch the company when "Get By" is set to "Domain Name".

Output

The output JSON contains detailed company information including:

  • id: Unique identifier of the company.
  • name: Company name.
  • domainName: Company's domain name.
  • logoUrl: URL to the company's logo.
  • createdAt / updatedAt: Timestamps in ISO 8601 format.
  • tier: Object containing tier id and name.
  • contractValue: Numeric value representing the contract amount.
  • accountOwner: Object with id, fullName, and publicName of the account owner.
  • isDeleted: Boolean indicating if the company is deleted.
  • deletedAt: Timestamp if the company was deleted.

If searching by domain name, the node returns the first matching company or an empty object if none found.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Plain API.
  • Uses GraphQL queries/mutations to interact with the Plain backend.
  • No additional external dependencies beyond the configured Plain API credentials.

Troubleshooting

  • Error: "Getting company by external ID is not supported by Plain API"
    This indicates that the node does not support fetching companies by external ID. Use "Company ID" or "Domain Name" instead.

  • Empty result or no company found
    Verify that the provided company ID or domain name is correct and exists in the Plain system.

  • API errors with field validation messages
    These errors indicate invalid input parameters. Check the input values for correctness and completeness.

  • Authentication errors
    Ensure the API key credential is correctly configured and has sufficient permissions.

Links and References

Discussion