TRBO icon

TRBO

Interact with the TRBO API

Overview

This node integrates with the TRBO API to manage links associated with a user profile. Specifically, the Create Link operation allows users to create a new link with customizable properties such as alias, URL, and visibility settings. This is useful for scenarios where you want to programmatically generate and manage short or branded URLs, control their accessibility, and organize them under a profile.

Practical examples include:

  • Creating marketing campaign links with specific aliases.
  • Generating public or private links for sharing resources.
  • Managing link visibility by hiding or making them unsearchable in public listings.

Properties

Name Meaning
Alias Alias for the link; a custom identifier or name for easier reference.
URL The actual URL that the link points to. (Required)
Public Whether the link is publicly accessible (true or false).
Hidden Whether the link is hidden from certain views or listings (true or false).
Unsearchable Whether the link should be excluded from search results (true or false).

Output

The node outputs JSON data representing the created link object returned by the TRBO API. This typically includes details such as the link's ID, alias, URL, metadata about its visibility (public, hidden, unsearchable), creation timestamps, and possibly usage statistics.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating with the TRBO API.
  • The base URL for API requests is https://trbo.link/api.
  • The node uses HTTP POST requests to /profile/auto/link endpoint to create links.
  • Proper configuration of the API authentication credential within n8n is necessary.

Troubleshooting

  • Missing Required URL: If the URL property is empty or invalid, the API will reject the request. Ensure the URL is correctly provided.
  • Authentication Errors: Invalid or missing API credentials will cause authorization failures. Verify the API key is set up correctly.
  • API Rate Limits or Quotas: Excessive requests may lead to rate limiting. Check TRBO API limits and adjust usage accordingly.
  • Invalid Alias or Metadata Values: Providing unsupported characters or formats in alias or metadata fields might cause errors. Use simple strings and boolean values as specified.
  • Network Issues: Connectivity problems can prevent successful API calls. Confirm network access to trbo.link.

Links and References

  • TRBO API Documentation (Assumed official API docs)
  • n8n Documentation on HTTP Request Node for understanding API integrations
  • General best practices for managing short links and URL redirection services

Discussion