Growchief icon

Growchief

Consume Growchief API

Overview

This node integrates with the Growchief API to manage workflows. It supports two main operations:

  • Get Workflows: Retrieves a list of available workflows from Growchief.
  • Start Workflow: Initiates a specific workflow on Growchief by providing enrichment data such as organization details, personal names, email, or URLs.

Typical use cases include automating the triggering of Growchief workflows based on external events or data processed in n8n, enabling seamless integration of Growchief's enrichment capabilities into broader automation pipelines.

For example, you might use this node to start a Growchief workflow that enriches lead data whenever a new contact is added in your CRM, passing along relevant information like email or organization name.

Properties

Name Meaning
Workflow Name or ID Select the workflow to start from a list loaded dynamically or specify its ID via expression.
Organization Name The name of the organization related to the enrichment (required if email and URLs are not provided).
First Name First name of the person for enrichment (required if email and URLs are not provided).
Last Name Last name of the person for enrichment (required if email and URLs are not provided).
Email Email address for enrichment (required if organization details and URLs are not provided).
URLs List of URLs related to the entity for enrichment (required if organization details and email are missing).

Output

The node outputs JSON data representing the response from the Growchief API:

  • For Get Workflows, it returns an array of workflow objects, each containing properties like name, id, and optionally description.
  • For Start Workflow, it returns the result of starting the specified workflow, which may include status, enriched data, or error information.

If an error occurs during execution, the output JSON will contain an error field with the error message or description.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the Growchief API.
  • The node uses HTTP requests to communicate with Growchief endpoints /workflows (GET) and /workflow/{workflowId} (POST).
  • No additional environment variables or configurations are explicitly required beyond the API credential.

Troubleshooting

  • Common Issues:

    • Missing or invalid API credentials will cause authentication failures.
    • Providing incomplete enrichment data (e.g., omitting all of organization name, email, and URLs) when starting a workflow will likely result in errors.
    • Specifying an invalid or non-existent workflow ID will cause the API call to fail.
  • Error Messages:

    • Errors returned from the Growchief API are captured and output as JSON with an error field.
    • Typical messages might indicate missing required fields or invalid workflow IDs.
  • Resolution Tips:

    • Ensure the API key credential is correctly configured and valid.
    • Provide at least one of the required enrichment inputs (organization name, email, or URLs).
    • Verify the workflow ID exists by first using the "Get Workflows" operation.

Links and References

Discussion