0BLA / THE GUIDES

One task. One answer.

From your first link to its integration. Choose what you want to do, follow the steps and find the settings in your dashboard.

01 · Create a link

A short link keeps your chosen destination: a page, a document or a profile that is already online.

  1. Sign in before creating the link so you can find it in your dashboard later.
  2. Paste the full destination address into the form. The alias is optional: leave it empty to receive an automatically generated address.
  3. Choose “Shorten”. Wait for the creation result, then copy the short address or retrieve its QR code.
  4. Open your link to check the destination before sharing it. This check may add a click to its counter.

Without an account: five minutes. A link created while signed out expires after five minutes. To place a link on a website, create it from your account and check its lifetime.

If an alias is already taken, choose another one. If you reach a limit, review your account’s links and plan. Expiration and maximum-click options are available with Pro and above.

Create several links

With Business or Enterprise, open Bulk in the dashboard. Paste one complete URL per line, start creation, then review each line’s result. If a URL fails, correct that URL before trying again.

Open bulk creation

Work with a team

With Business or Enterprise, you can invite two collaborators in Team. They can view and edit your links, including destinations and limits. You retain control over deleting links. Each member’s personal plan stays the same.

  1. Check the email address, then choose Invite. The invitation stays pending even if the person already has an account.
  2. The recipient opens the email link. They sign in with the same address, or create an account and verify their email, then choose Accept invitation in Team.
  3. The link is valid for seven days. Resend creates a new link and invalidates the previous one. Cancel invitation prevents acceptance. If sending is not confirmed, the invitation stays visible and can be resent after one minute.

Your own memberships are shown separately. You can leave a team from this section even with a free account. Shared team links are available while the membership and the owner’s plan allow access.

Removing a member or leaving a team revokes access to shared links. A suspended owner account or a plan that no longer permits sharing also suspends that access. Links remain their creator’s property.

Open my team

Find my account settings

The Profile page contains your picture, plan and subscription, password settings and API keys. Back to links returns to the dashboard. Deletion and cancellation actions are kept separate from everyday settings.

Open my profile

02 · Place a link on a website

Replace your button’s destination with the short link you created in 0bla. The button text and the final destination stay the same.

  1. Copy the link from your dashboard.
  2. In your website editor, paste it into the button’s link field. In HTML, replace the href value.
  3. Save the page, then check the button on desktop and mobile.
HTML · REPLACE THE PLACEHOLDER
<a href="YOUR_SHORT_LINK">
  Discover my project
</a>

Replace YOUR_SHORT_LINK with the address returned by 0bla and adapt the text to the content. The same approach works for a LinkedIn profile, a document or a product page.

On paper

The dashboard QR code action represents the same short link. Before printing, test a scan and make sure the link will last as long as the printed material.

Use my own domain

With Business or Enterprise, the Domains tab lets you add a custom domain. Follow the DNS instructions shown there, then verify the domain before using it to create links.

Each new domain receives two records: a CNAME pointing to the service and a TXT specific to your domain to confirm ownership. Copy the names and values shown, keep the TXT, then use Verify domain after propagation. If configuration fails, the domain stays pending and the next action is shown.

Open my domains

03 · Understand clicks

In your dashboard, choose “Statistics” on the link’s row. You are viewing that link’s data in your account.

A click count is not an exact count of people. Repeat visits, bots and automatic previews may request the same link. A click does not prove that a document was read or a purchase was made.

Clicks
The number of requests recorded for the link. A link with no activity shows zero.
Advanced statistics
With Pro and above: daily series, countries, devices and browsers to observe trends.
CSV export
With Pro and above: download statistics from your dashboard to analyse them in your own tool.

The homepage chart illustrates how statistics are presented. Dashboard counters come from your links.

04 · Use the API

To create links from a program, use the external API with an API key. This is available with Business and Enterprise.

  1. In your profile, create an API key and store it in your server’s private configuration.
  2. Send a POST request with the url field and an Authorization: Bearer header. The alias field is optional.
  3. Check the HTTP status and status in the response. Use short_url only after success; a successful creation returns HTTP 201.
HTTP · EXAMPLE
POST https://0bla.com/api/external-create.php
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{"url":"https://example.com"}

An incorrect or revoked key is rejected. The account must be active and its plan must still include API access. The current limit is 100 creations per hour per key; reaching the limit returns HTTP 429.

Keep your key on your server. Do not put it in HTML, public JavaScript or a link’s address. Revoke an exposed key from your profile.

Dashboard operations use a different interface: the account session and its CSRF token. Their reference covers creation, editing, deletion, statistics and export; it does not authenticate with the Bearer key above.

05 · Configure a webhook

A webhook sends an event to your tool when a link is used. 0bla webhooks are available with Business and Enterprise.

  1. Prepare a public HTTPS receiver on your server or in your tool. Internal addresses and redirects are refused.
  2. Open the dashboard Webhooks tab. Enter a clear name and the receiver address, then add the webhook.
  3. For a custom receiver, store its secret and verify the signature before processing the data. Consult the reference for the exact format.
  4. Verify receipt using a test link you control, then verify processing by your tool. A webhook appearing in the list does not confirm delivery.
Event
link_click · A click on an account link.
Configuration
Up to five webhooks per account. Activate, deactivate or remove a webhook from its row.
Delivery
The current sender makes one attempt, with a two-second timeout. There is no automatic retry; your receiver should respond promptly.

Slack, Discord and Mattermost connectors adapt the message format. For a custom receiver, the reference describes the 0bla JSON and signature headers.

06 · Troubleshoot a redirect

Start by checking the full short address and the message shown. The link, its lifetime and the destination are three separate things to check.

Link not found · 404
Copy the link again from your dashboard. Check the alias, domain and whether it was deleted.
Expired link · 410
The expiration time has passed. Links created without an account last five minutes. From your account, check the link’s lifetime and your plan’s options.
Click limit reached · 403
The link has reached its maximum number of clicks. If you manage it, review its settings; otherwise, contact its creator.
Password required
Use the link password provided by its creator. This is not your 0bla account password.
Different mobile destination
Check the iOS and Android destinations in the link’s edit settings. Without a rule for the device, the main destination is used.

If the link redirects correctly but the final page is unavailable, the issue is at the destination. For a custom domain, also check its status and DNS configuration in your dashboard.