Mailtrap icon

Mailtrap

Interact with Mailtrap API
Join our community

Actions5

Overview

This node updates a contact in the Mailtrap system. It allows users to modify contact details such as email, custom fields, subscription status, and list memberships. This is useful for maintaining up-to-date contact information in email marketing or customer management workflows.

Typical use cases include:

  • Correcting or updating a contact's email address or personal details.
  • Managing subscription preferences by marking contacts as unsubscribed.
  • Organizing contacts into specific mailing lists or excluding them from others.
  • Enriching contact profiles with additional custom data fields.

Properties

Name Meaning
Authentication Method of authentication: either "API Token" or "Bearer Token".
Account ID The Mailtrap account identifier where the contact exists.
Contact ID or Email Identifier for the contact to update; can be either the contact's unique ID or their email.
Email New or updated email address for the contact.
Fields (JSON) Additional contact fields provided as a JSON object, e.g., first name, last name, etc.
List IDs to Include Contact Comma-separated list of mailing list IDs to which the contact should be added.
List IDs to Exclude Contact Comma-separated list of mailing list IDs from which the contact should be removed.
Unsubscribed Boolean flag indicating whether the contact is unsubscribed from emails.

Output

The node outputs JSON data representing the updated contact object as returned by the Mailtrap API. This typically includes the contact's ID, email, subscription status, associated lists, and any custom fields.

If binary data were involved (e.g., attachments), it would be summarized here, but this node deals only with JSON contact data.

Dependencies

  • Requires an active Mailtrap account.
  • Needs an API key credential or bearer token for authentication.
  • The user must provide the Mailtrap account ID.
  • Network access to Mailtrap's API endpoints.

Troubleshooting

  • Invalid Authentication: Errors may occur if the API token or bearer token is incorrect or expired. Verify credentials and regenerate tokens if necessary.
  • Contact Not Found: If the provided Contact ID or email does not exist, the update will fail. Confirm the contact identifier is correct.
  • Malformed JSON in Fields: The "Fields (JSON)" property must be valid JSON. Syntax errors will cause failures. Use JSON validators before input.
  • List IDs Format: Ensure list IDs are comma-separated numbers without extra spaces or invalid characters.
  • Permission Issues: The API key used must have permissions to update contacts within the specified account.

Links and References

Discussion