Falconyte Email icon

Falconyte Email

Send emails using Falconyte's transactional email API.
Join our community

Actions28

Overview

This node performs bulk upsert operations on email contacts using Falconyte's transactional email API. It allows users to add or update multiple contacts in one request, optionally applying tags to all contacts. This is useful for managing large contact lists efficiently, such as syncing contacts from a CRM or marketing platform to Falconyte for email campaigns.

Use Case Examples

  1. Bulk upsert a list of contacts with their details to keep the contact database updated.
  2. Apply a set of tags to multiple contacts in one API call to categorize them for targeted email campaigns.

Properties

Name Meaning
Contacts An array of contacts to be upserted. This can be provided as JSON directly or via an expression referencing input items.
Tags (JSON) Optional JSON array of tags to apply to every contact in the bulk upsert request.

Output

JSON

  • json - The JSON response from the Falconyte API after performing the bulk upsert operation, typically containing details about the upserted contacts and any applied tags.

Dependencies

  • Requires an API key credential for Falconyte's transactional email API to authenticate requests.

Troubleshooting

  • Ensure the 'Contacts' input is a valid JSON array; invalid JSON will cause parsing errors.
  • If tags are provided, they must be valid JSON arrays; otherwise, the request may fail.
  • API errors from Falconyte, such as authentication failures or invalid data, will be returned in the node output. Check the error message for details.
  • If the node throws 'Unsupported operation' or 'Unsupported resource' errors, verify that the resource is set to 'Email' and operation to 'Bulk Upsert Contacts'.

Links

Discussion