Instasent Data Source icon

Instasent Data Source

Send contacts and events to an Instasent Data Source

Actions3

Overview

This node integrates with the Instasent Data Source to manage contact data by creating or updating contacts. It is particularly useful for synchronizing user information from various systems into Instasent, enabling real-time or batched updates of contact records.

Common scenarios include:

  • Adding new contacts to Instasent when users register on a platform.
  • Updating existing contact details such as email, phone number, or custom fields.
  • Triggering immediate processing of contact data for subsequent event handling in workflows.

For example, you might use this node to upsert a contact with specific properties like name and email, optionally processing it instantly to immediately trigger related events downstream.

Properties

Name Meaning
User ID The unique identifier for the contact to create or update.
Contact Properties A collection of key-value pairs representing the contact's fields to set or update. Options are loaded dynamically from available contact properties.
Instant Boolean flag indicating whether to process the contact immediately instead of queuing. Useful when an event needs to be added for this contact in the next workflow step. Not recommended for high-volume operations.

Output

The node outputs an array of JSON objects, each representing the response from the Instasent API for each input item processed.

  • For the "Create or Update" operation on contacts, the output JSON contains the updated or created contact data as returned by the Instasent API.
  • If the "Instant" option is enabled, the contact is processed synchronously; otherwise, it is queued.
  • In case of errors (if not continuing on fail), the node throws an error; if continuing on fail is enabled, the output JSON includes an error field with the error message.

No binary data is output by this node.

Dependencies

  • Requires an API authentication token credential configured in n8n to authenticate requests to the Instasent Data Source.
  • Uses the Instasent REST API endpoints /stream/contacts for contact upsert operations.
  • Dynamic loading of contact property options depends on the API's metadata availability.

Troubleshooting

  • Error: Network or Authentication Failure
    Ensure that the API authentication token is correctly configured and has sufficient permissions. Verify network connectivity to the Instasent API endpoint.

  • Error: Invalid User ID or Missing Required Fields
    Confirm that the "User ID" is provided and valid. Also, ensure that required contact properties are included according to Instasent's schema.

  • High Volume Processing Issues When Using Instant Flag
    The "Instant" option processes contacts synchronously and is not recommended for bulk operations. For large datasets, disable this option to queue contacts and avoid performance bottlenecks.

  • Unknown Error Occurred
    This generic error may indicate unexpected API responses or internal issues. Check the node's execution logs and API status.

Links and References

Discussion