Superchat icon

Superchat

Retrieve data from the Superchat API

Actions18

Overview

This node integrates with the Superchat API to create a new contact in the system. It allows users to specify detailed information about the contact, including personal details, multiple email addresses, phone numbers, and custom attributes. This node is useful for automating the addition of contacts into Superchat from other systems or workflows, such as CRM synchronization, lead generation forms, or customer onboarding processes.

Practical examples:

  • Automatically adding new leads captured via a web form into Superchat as contacts.
  • Syncing contacts from an external database or CRM into Superchat.
  • Enriching contact data by programmatically creating contacts with custom attributes based on business logic.

Properties

Name Meaning
First Name The first name of the contact
Last Name The last name of the contact
Gender The gender of the contact; options are Female, Male, Diverse
Email Addresses One or more email addresses associated with the contact
Phone Numbers One or more phone numbers associated with the contact
Custom Attributes Additional custom-defined attributes for the contact, mapped according to resource schema

Output

The node outputs an array of JSON objects representing the created contacts. Each object contains the details of the newly created contact as returned by the Superchat API, including all standard fields (name, gender, emails, phones) and any custom attributes set during creation.

There is no indication that this node outputs binary data.

Dependencies

  • Requires an active connection to the Superchat API using an API key or authentication token configured in n8n credentials.
  • The node depends on the Superchat API being accessible and the user having permissions to create contacts.
  • No additional external dependencies beyond the Superchat API and its authentication.

Troubleshooting

  • Common issues:

    • Missing or invalid API credentials will cause authentication failures.
    • Providing improperly formatted email addresses or phone numbers may result in API validation errors.
    • Attempting to create contacts with duplicate unique identifiers (if enforced by Superchat) might cause errors.
    • Custom attributes must conform to the expected schema; otherwise, the API may reject the request.

  • Error messages:

    • Authentication errors typically indicate invalid or missing API keys; verify credential setup.
    • Validation errors will specify which field failed; ensure all required fields are correctly formatted.
    • Network or timeout errors suggest connectivity issues with the Superchat API endpoint.

Links and References

Discussion