AvantGuard - Maileroo icon

AvantGuard - Maileroo

AvantGuard - Maileroo
Join our community

Actions5

Overview

This node operation updates an existing short link by modifying its properties such as the route, destination URL, title, description, and other metadata. It is useful in scenarios where you need to change the target URL or update the preview information of a previously created short link without creating a new one. For example, if a marketing campaign's landing page changes, you can update the short link to redirect users to the new page seamlessly.

Properties

Name Meaning
Id Unique identifier for the short link to update. It is a composite text of the domain and route (e.g., Maileroo.to/mylink). Prepending https:// forms the full URL of the short link. This property is required.
Additional Body Fields Optional fields to update various attributes of the short link:
- Route: The path segment of the short link.
- Destination: The URL where the short link redirects.
- Title: Text shown in link previews.
- Description: Text shown in link previews.
- Image: URL of the image shown in link previews.
- Favicon: URL of the favicon shown in browsers during redirects.
- Consent: Boolean indicating if visitor consent is requested before storing cookies.
- Clicks: Integer count of clicks on the short link.
- Created At: Date/time when the link was created (UTC+0).
- Updated At: Date/time when the link was last updated (UTC+0), including click updates.

Output

The node outputs JSON data representing the updated short link object. This includes all the properties of the short link after the update, such as its id, route, destination URL, preview metadata (title, description, image, favicon), consent setting, click count, and timestamps for creation and last update.

No binary data output is involved.

Dependencies

  • Requires an API key credential for authenticating with the Maileroo service.
  • The node communicates with the Maileroo API endpoint at https://smtp.maileroo.com.
  • Proper configuration of the API authentication credential within n8n is necessary.

Troubleshooting

  • Invalid Id Error: If the provided Id does not correspond to an existing short link, the API will likely return an error. Ensure the Id is correct and includes the proper domain and route.
  • Authentication Failures: Missing or incorrect API credentials will cause authorization errors. Verify that the API key credential is correctly set up.
  • Invalid Field Values: Providing invalid URLs or improperly formatted dates in additional body fields may result in validation errors. Confirm that URLs are valid and date strings follow expected formats.
  • Network Issues: Connectivity problems to the Maileroo API endpoint can cause request failures. Check network access and proxy settings if applicable.

Links and References

Discussion