Actions6
Overview
This node integrates with a URL shortening service API, allowing users to manage shortened URLs programmatically. Specifically, the "Atualizar URL" (Update URL) operation enables updating properties of an existing shortened URL by its ID.
Common scenarios for this node include:
- Modifying the destination (long) URL of an existing short link.
- Changing the redirection type or adding password protection.
- Setting metadata such as title, description, and image for better social sharing previews.
- Applying targeting rules based on geography, device, or language.
- Adding tracking pixels or associating the URL with specific marketing channels.
- Defining expiration dates or custom aliases for better management.
Practical example: A marketing team can update a campaign's short URL to point to a new landing page without changing the short link itself, preserving all previous shares and analytics.
Properties
| Name | Meaning |
|---|---|
| ID Da URL | The unique identifier of the URL to be updated (required). |
| URL Longa | The new long URL that the short link should redirect to (required). |
| Alias Personalizado | Custom alias for the shortened URL, replacing the default generated one. |
| Tipo De Redirecionamento | Type of redirection for the short URL; options are: "Direto" (direct), "Frame", or "Splash". |
| Senha | Password to protect access to the shortened URL. |
| Domínio Personalizado | Custom domain to use for the shortened URL; selectable from predefined domains. |
| Data De Expiração | Expiration date/time for the short URL in format like "YYYY-MM-DD HH:mm:ss". |
| Título Meta | Meta title for the short URL, used in social previews. |
| Descrição Meta | Meta description for the short URL, used in social previews. |
| Imagem Meta | URL to a JPG or PNG image used as meta image for social previews. |
| Geo Targeting | Geo-targeting data specifying which geographic locations the URL targets. |
| Device Targeting | Device-targeting data specifying which devices the URL targets. |
| Language Targeting | Language-targeting data specifying which languages the URL targets. |
| Pixels | Array of pixel IDs for tracking purposes. |
| Channel ID | Identifier of the marketing channel associated with the URL. |
| Deep Link | JSON object containing app store links for deep linking functionality. |
Output
The node outputs JSON data representing the result of the update operation. This typically includes confirmation details about the updated URL, such as its ID, updated fields, status, and possibly any error messages if the update failed.
No binary data output is indicated for this operation.
Dependencies
- Requires connection to the URL shortening service API.
- Needs an API authentication token or key configured in n8n credentials to authorize requests.
- No other external dependencies are indicated.
Troubleshooting
- Invalid URL ID: If the provided URL ID does not exist, the API may return an error indicating the resource was not found. Verify the ID is correct.
- Authentication errors: Missing or invalid API credentials will cause authorization failures. Ensure the API key/token is correctly set up.
- Invalid field values: Providing malformed URLs, unsupported redirect types, or incorrectly formatted expiration dates may cause validation errors.
- Alias conflicts: Attempting to set a custom alias already in use might result in an error. Choose a unique alias.
- Network issues: Connectivity problems with the API endpoint can cause timeouts or request failures.
To resolve these, verify input parameters, check credential configuration, and ensure network connectivity.
Links and References
- Refer to the URL shortening service API documentation for detailed field definitions and constraints.
- Consult n8n documentation on setting up API credentials and using HTTP-based nodes for similar integrations.