ceven

Y gy

Turns long URLs into branded short links and QR codes automatically, organizes them with tags for campaign tracking, and manages link lifecycles across your marketing stack.

Try Y gy in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Y gy integration

    • Describe the outcome and Ceven picks the right Y gy calls, fills the parameters, and checks the result.
    • Structured, agent friendly tool schemas so each call runs reliably instead of by guesswork.
    • Rich coverage for reading, writing, and querying your Y gy data, across all 8 of its actions.

  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Y gy access.
    • Per user and per environment credentials instead of shared keys.

  3. Agent optimized design

    • Actions are tuned from real success and error rates so reliability climbs over time.
    • Full execution logs so you always know what ran in Y gy, when, and on whose behalf.
    • The agent pauses and asks when Y gy is unclear instead of plowing ahead.

  4. Enterprise grade security

    • Fine grained access so you control which agents and people can reach Y gy.
    • Least privilege by default, read scopes first and only the writes a workflow needs.
    • A full audit trail of every Y gy action to support review and sign off.

Supported tools

Every action Ceven's agents can run on Y gy, and when to use it.

Create short link
Use this when you need to shorten a long url into a branded link with an optional custom alias.
Create tag
Use this to create a new category tag to organize and group related short links.
Delete short link
Use this to permanently remove a specific short link using its unique id.
Delete tag
Use this to remove a tag from the organization by providing the tag id.
List all links
Pull a paginated list of all existing short links to audit your active URLs.
List all tags
Retrieve every tag associated with the organization to see available categories.
Get link details
Pull the full metadata and destination URL for a specific short link id.
Register user
Use this to onboard a new user account with a username, password, and email address.
Create Y.gy Short Link
Tool to create a new short link with optional custom domain or alias. use when you need to shorten a long url into a branded link.
Delete Y.GY Short Link
Tool to delete a specific short link by its id. use when you need to remove a short link after confirming its id.
Delete a tag by ID
Tool to delete a tag. use when you need to remove a tag by its id after confirming it exists.
Get all links
Tool to fetch all short links with optional pagination. use when you need to list existing links with filters.
Get all tags
Tool to retrieve all tags associated with the organization. use when you need to list all available tags for categorizing resources.
Get Short Link Details
Tool to retrieve details for a short link. use when you have a link id and need its metadata.

14 actions · scroll to see them all

Frequently asked questions

Ceven analyzes the destination URL and the context of your workflow to suggest a readable alias. If you provide a specific keyword in your prompt, the agent will attempt to use that as the slug. If the alias is already taken within the y.gy system, the agent will catch the error response and automatically append a random short string or a date stamp to ensure the link is created successfully without failing the entire workflow. You can also set a naming convention in your agent instructions to ensure all links for a specific project follow a consistent pattern for your brand.
Yes. Ceven can create tags in y.gy and assign them to links based on the source of the data. For example, if you are pulling links from a Google Sheet that has a column for campaign name, the agent will first check if a tag with that name exists. If it does not, the agent calls the create tag tool first and then applies that tag to the newly created short link. This ensures that your y.gy dashboard remains organized and that you can filter your links by project or client without manual tagging.
The y.gy API returns a specific error code when a link id is not found. Ceven is programmed to handle this gracefully. Instead of crashing the workflow, the agent will log that the link was already missing or previously deleted and then proceed to the next item in your list. This is particularly useful when running cleanup workflows across thousands of links where some may have been removed manually through the y.gy web interface before the agent started its run.
Ceven is bound by the rate limits and tier restrictions of your y.gy account. One specific quirk of the y.gy API is that free tier accounts have a strict limit on the number of custom aliases allowed per day. If the agent hits this limit, you will see a rate limit error in the workflow logs. To resolve this, you can either upgrade your y.gy plan or instruct the agent to use random slugs instead of custom aliases, which typically have higher thresholds for creation.
Yes. You can provide a list of long URLs from another service, and Ceven will iterate through them to create equivalent short links in y.gy. The agent can pull the metadata from your old provider, create the corresponding tag in y.gy to maintain organization, and then output a CSV mapping the old short link to the new y.gy short link. This allows you to update your social media bios and ad campaigns in one coordinated sweep.
Ceven does not store your links in a permanent database. It acts as the orchestrator between your data sources and the y.gy API. When you ask for a list of links, the agent calls the list all links tool in real time to fetch the current state from y.gy. However, if you save the output of a workflow to a Notion page or a database, that record becomes your local copy. The source of truth always remains within your y.gy account.
Yes. Since y.gy provides QR code generation for every short link created, Ceven can trigger the link creation and then retrieve the associated QR code assets. You can build a workflow that takes a list of product pages, creates y.gy short links for each, and then uploads the resulting QR code images to a cloud storage folder like Google Drive or Dropbox. This removes the need to manually download and rename images for every single product in your catalog.
The register user tool allows the agent to create new accounts programmatically. This is primarily used for enterprise setups where you want to provision y.gy accounts for team members based on a directory in Okta or Azure AD. The agent takes the email, username, and password and submits them to the y.gy registration endpoint. Note that you should use a secure secret manager for passwords rather than typing them in plain text within your workflow prompts to maintain security.

Alternatives to Y gy

Other tools that solve a similar problem. Ceven supports these too, so you can switch or run more than one at once.

Bitly logoBitlyRebrandly logoRebrandlyTinyURL logoTinyURL

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Y gy and the rest of your stack, describe the outcome, and its agents handle the work end to end, days of it in minutes.

Get started for free